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1.0 INTRODUCTION 


"tee Software stands between the user and the machine oe.” 
Hartan De Milfs 


The Software Engineering System (SES) provides task oriented or 
procedural access to a collection of Software IToals» running on the 
Network Qperating System (NOS). An underlying philosophy of SES 


is 3 where there's a function or task to be dones provide a 
PROCEDURE to do it. Programs are. generality not used directiy»s 
rather they are accessed via SES procedures that provide a 


consistent access method. 


This SES User's Handbook is intended both as a tutorial 
introduction for new SES users (who should definitely read this 
chapter)» and aiso as a reference manual for experienced SES 
basherse Although this is not the ogniy existing retevant SES 
documents it's the main trunk of the tree of knowledge of what SES 
PROCEDURES are availtablte. Because this SES Userts Handbook is 
usually updated only at SES Releases - a big deal - news of new SES 
stuff appears in the TOOLS BULLETIN roughly every months in various 
SES NEWS memoss and may even be passed by word of mouthe 


Software Produstion covers many areas other than the narrow 
fields of "“assembferss compilers and toaders™. To cover the wider 
areaS»s we need good toots. SES provides the tools. This SES User's 
Handbook is arranged in chapters that "cluster™ around retated 
functional areas (such as document formattings file managements text 
processing and so On). This chapter (chapter 1) is a general 
introduction to the concepts of SES and its usee The remaining 
chapters of this handbook cover the functional areas. Betow is a 
brief summary of the contents of the remaining chapters. 


A major proportion of SES is devoted to the CYBER 180 SIMULATED 
ENVIRONMENT» running on the CYBER 170. Chapter 9 contains 
information on building the virtuat environments simulatings and 
transferring text files back and forth hetween the CYBER 180 and 
CYBER 170. Chapter 11 describes the CYBER 180 OBJECT CODE UTILITY» 
used to manage CYBER 180 Object Text. One of CYBER 180's 
significant differences from CYBER 170 Is the use of reali eight-bit 
ASCII. NOS runs on a six-bit oriented systems and provides only 
partial support of ASCII. SES provides extensive support § (for 
ASCII. The CYBIL compiter is ASCII orienteds as is the CYBIL 
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formatters the documentation facilitiess many of the text 
manipulation toolss and the source text maintenance utilities. 


Of courses Compilerss Assembiers and Loaders go play a part in 
software production - Chapter 8 covers tots of useful goodies in 
this areas the most important being the CYBER IMPLEMENTATION 
LANGUAGE - CYBIL.»~ As wel! as a CYBIL compiters, Chapter 8 also 
describes CYBIL-CC INTERACTIVE DEBUG» a symbolic debug facility» 
based on CYBER Interactive Debug but oriented towards CYBIL code. 


Production of farge (Cor smati) software systems requires some 
means of MANAGING SOURCE TEXT so you don't drown in nitpicking 
details. SES supplies a comprehensive collection of source text 
maintenance procedures geared up for the ASCII version of MODIFY 
(known as MADIFY) to manage CYBIL source text for yous ors in facts 
any other ASCII source texts such as documentss data dictionaries» 
process descriptions and so on. These facitities are described in 
Chapter 4. Chapter 10 describes the NOS-170 version of the CYBER 
180 Source Code Utility (SCU). There's also a set of procedures to 
make UPDATE easier to five withs described in Chapter 16, 


When you've compiled or assembled your source text of course 
there's the embarrassing question of OBJECT CODE MANAGEMENT. 
Chapter 5 covers LIBRARY MANAGEMENT - a collection of procedures 
that interface to the NOS LIBEDIT utitity. These tibrary management 
procedures can in fact handle all sorts of things other than just 
object code. 


One of the first hurdles to clear on most computer systems seems 
to invotve the question "how do I print a File"? Chapter 2 shows 
that printing files reality can be easy. 


An important part of software production involves DGCUMENTATION. 
SES has a coltection of tools that make a fun job of generating 
beautiful documents. Documentation aids revolve around the TXTCODE 
document formatters used to produce this Handbook. Chapter 3 covers 
document formatting. 


Preparing beautifully formatted source text for high tevel 
language processors is something you fike to haves but you'd rather 
not do it yourself. Chapter 12 covers SOURCE TEXT PREPROCESSORS of 
various typess the most important from the SES viewpoint being 
CYBFORM - the formatter for CYBIL. 


In any time sharing systems MANAGING FILES is an important part 
of ftifes, as is FINDING DUT WHAT*S GOING ON. Chapter 6 relates to 
getting informations such as your filess timitss dayfiles while 
Chapter 7 covers the aspect of dumping your files to tapes and 


COMPANY PRIVATE 


1-3 

CDC - SGFTWARE ENGINEERING SERVICES 
7/30/81 

SES (Release 17) User's Handbook REV: AB 7 


1.0 INTRODUCTION 


PO PO RE PE PE RE PO ON PO PO PE PE FE PE PE PE PE OE OE 8 OO PE PE PE PO PE PE RE BG OE PEG PE RY PE PE PE PD OA TOPE EE OE OE PE OO OE 90 PE PO 98 PE PO OF OE PE PE 08 PE PE 28 PE 08 PE 8 08 ae 


hanging on to files you want to hang on to. 


An amazing amount of the daity job of software production 
invoives massaging text in some way or another. Chapter 14 covers 
many aspects of TEXT MANIPULATION. Conversion of character sets 
tends to be a way of Jife rather than an infrequent exercises and 
there are utilities to work well with the NOS version of ASCII. 


Software Production really is a community activitys and Chapter 
13 describes facilities for users to talk to each other via a mail 
system. 


SES PROCEDURES take care of the detaiis of using softwares such 
as tlocatings returning and rewinding filess obtaining required 
memorys obtaining required utility programs to perform tasks» and so 
ons teaving you free to specify what you want donee To state it 
briefly : 


YOU decide WHICH SES PROCEDURE you want to use for the job. 
SES generates the JOB CONTROL STATEMENTS to do the job. 


Using SES» you can run a procedure directty as part of your 
interactive sessions or you can make many of the procedures run 
independently as batch jobs. 


Experienceds curious or masochistic users wishing the joy of 
creating their own gourmet SES procedures can read the SES Procedure 
Writer's Guide. 


At the end of this chapter there's a list of documents relevant 
to peaceful and productive coexistence with NOS. 


As you read this documents you'll) notice that aithough many SES 
procedures have Jots of parameters» most oarameters are optional. 
For exanptes the PRINT and FORMAT procedures haves respectivelys ten 
and eighteen parameters; 90% of PRINT and FORMAT usage requires only 
one parameter. Finaltys the yusability of SES results from people 
using it and feeding back their (constructive) criticisms, ideas for 
enhancements to existing facilities and ideas for new facitities. 
We hope you't!i do the same. 


Note : Wwe strongly recommend that you read all of this 
introductory chapter (chapter 1) before reading other chapters. As 
you read this introductions try using some of the SES procedures 
described in the examples as you gO. Finally : 

When all etse failss read the documentation! 


COMPANY PRIVATE 


1-4 
CoC - SOFTWARE ENGINEERING SERVICES 
7/30/81 
SES (Release 17) User's Handbook REV: AB 


FH DO PE OO OO PE POD B8 OO F8 PE PE TE OE RE PO PE PO OE PO PE PEPE PE FO PG OF PE PO PEPE FO PO BE PE RO ME OD PE OE TE 88 PE TE BO OF PE PE RE PD TE 8 8 08 OE TO OE 1 TE 80 20 08 0 6 EPO 


1.0 INTRODUCTION 
1.1 USING AN SES PROCEDURE 


1.1 USING_AN_SES_ PROCEDURE 

Whether you use SES interactivelys, or run it in a batch jobs the 
usage is the sames as shown here 3 

seseprocedure_name tist_of parameters. 
the ses before the period starts the SES processor. The period {(.) 
following ses is ceauired to keep NOS happy. The statement directs 
the SES processor to tocate the procedure given by procedure names 
and when it has been tlocateds to process that procedure and 
substitute the (optional) parameters given by tist_of parameters» 
and finallys execute the procedure either directly ("while you 
wait”) as part of your interactive sessions or SUBMIT the procedure 
as an independent jobs. For exampte : 
seseprint blivet 
PRINTs file blivet on the ASCII printers and : 
sesecount tines in grundge 


COUNTs the number of tines in file grundge. 


1.2 PARAMETERS _EQR_ SES PROCEDURES 

As mentioned aboves you use an SES procedure by typing a 
statement of the form 3: 

seseprocedure_name ftist lof parameters 
where fist_of_parameters is the parameters required for that 
particular procedure. 
Parameters may be specified by keywords for example ; 
seseprint f=emyfile 

In this examples f is the parameter keyword or parameter games and 
myfile is the parameter value. Generailys the name on the teft of 


the equal sign is the parameter keyword or parameter names while the 
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thing on the right of the equal sign is the parameter yalue. 


While parameters may be specified by keywords it's atso possible 
(and usualty more convenient) to leave out the keyword and the equal 
sign and specify parameters positionally. This means that you dontt 
have to type the keyword or the equal signe For example ; 


sesecopyacr infiles outfiles 3.279 


When keywords are useds it doesn't matter in what order you code the 
parameters. The use of COPYACR above could have been coded ; 


sesecopyacr ozoutfiles 342799 izinfile 


however if you want to code parameters without using keywordss you 
must get them in the right order. 


When you use an SES procedure you can code parameters In a 
mixture of both positional and Keyword fForms,s whatever suits you. 


Every SES procedure expects its parameters in a specific order. 
When you code a parameter by keywords you effectively “tab” the 
parameter number to that "position". That's whys in the example 
aboves we were able to code 3 ‘ 


ozoutfiles 32279 


by coding ozoutfile we “tabbed"™ the parameter to the second 
"position". The next parameter (coded without the keyword) was 
already in the third "position". But when we wanted to code the 
input file name we had to specify it by keyword in order to “tab"™ 
back to the first parameter position. 


Use of positional parameters sometimes teads to minor problems 
when what you think is a fite name is in fact the keyword for a 
parameter. For examples many SES procedures have a parameter called 
groups which is the name of a group (or mufti record) file. If you 
use a procedure such as COLLECTs for instances like this ; 


sesecollect (toms dicks harry) group 
-TOG FEW VALUES GIVEN FOR PARAMETER- 


in this cases the error message actually means 3: you have coded a 
parameter keywords and not supptied a yalue for that parameter. In 
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such cases» you have to either code groupsgroup» or code the 
positional value in string quotes =: *group*’. 


Most SES procedures use short names like i and f for parameter 
keywordss so it's best if you avoid singie tetter filenames. For. 
example 3 

seseuptotow f 
wii cause an errors because f is one of the keywords for the first 


parameter of JPTOLOW. You can either code the parameter as f=f» or 
code it as "ff", or use a name tike grab or junk for the filename. 
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1e2e1 TYPES OF PARAMETER VALUES 


Values supplied for parameters may be names» pnupberss or 
character stringse These are described in detail here, 


1.2.1.1 Names_as Parameter Values 

A NAME is from one to seven characters tong. It must start with 
a fetters and may contain only tetters or digits. For exampie : 
As ZQ9IAP6» and CYBIL are valid namess whereas : lAJ» input files 
and oversizedname are invalid names according to the rules above. 
An example of using names in an SES procedure is 3 


seseuptolow izhibrows ozlowbrow 


for converting file hibrow from upper case to tower case with the 
result appearing on file towbrow. 


122.122 Numbers_as_ Parameter Vaiues 


A NUMBER contains gnly digits. The number may be followed by an 
optional BASE. For example : 


579(10) 1493 are DECIMAL NUMBERS» or numbers to the 
base 10. 

677(8) 1754(8) are OCTAL NUMBERS» or numbers to the 
base 8. 

OAF6(16) 3€8(16) are HEXADECIMAL NUMBERS» or numbers to 


the base 16. Note that hexadecima! 
numbers must begin with a decimal 
digits even if you have to start them 
with a zero. This avoids a potential 
confusion of a hexadecimal number with 
a name. 
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Numbers such as 6789(8) and 3A5(10) are distiked by SES. Use of 
numeric parameters occur in procedures like : 


seseprint copies=3s fzyinyang 


to print three (3) copies of file yinyang on the ASCII printer. 


1.2.1.3 Chacacter Strings as Parameter Values 


A CHARACTER SIRING is any arbitrary string of characters enclosed 
in singie quote signs {(*). If you wish to inctude a single quote 
sign in a strings you must represent it by two quote signs in a 
row. For exampie ?: 

*this is an example of a character string! 
Squote signs must be represented by two ** quote signs in a row?® 

You use strings in SES procedures when you have to supply strange 
names such as SYM$SM» and when supplying sentences to procedures : 

sesegenupcf d='mces$c30? 
when generating an update compiie Files and : 


sesetink170 binfiles xid="tidset(usepsswisysssubst=z=swisy-Sswisy.1$)? 


to give extra loader directives to LINK170. 
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1.222 RANGES OF PARAMETER VALUES 


Some SES procedures handle parameter values in the form of a 
RANGE.» For instances procedure COPYACR has a parameter named cols» 
which represents a pair of column numberse You can write the cols 
parameter in the form 3 

c0ts230265 
the pair of periods tis called an ELLIPSIS. The range specification 
consists of a flow sides on the left of the ellipsiss and a high side 
on the right of the ellipsis. Another example of a procedure that 
accepts ranges is GENCOMPs which accepts ranges of module names» 
like this : 
sesegencomp almaden.-ebertero 


which refers to all modules atmaden through bertero inclusives and 3: 


seseselect tines 10..20 of gailoop 


to display tines 10 thru 20 of file galioop at the terminal. 
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1.22.3 LISTS OF VALUES FOR PARAMETERS 


Some SES procedures handte parameters consisting of many values. 
For instances you can tell procedure PRINT to print a whoie bunch of 
filess like this 3 


seseprint fz(atlass ortions mercurys pegasuss siriuss hermes) 


the value coded for the f parameter is called a VALUE LISI. A value 
list must be enclosed in parenthesess as shown in the example. The 
individual items in a vatue fist are called ELEMENIS of the tists 
and they are separated from each other by a comma. 


Elements in a value list can aiso be ranges 3: 


sesesetect tines (1s 29 39 120017» 210025) of widget 


An element of a value tist may itself be another vaiue ftist. For 
instances procedure GENCOMP has a parameter called abs which can be 
coded in the form 3: 


gencomp abz((riestings mondavilds gamays (chenins wente)) 


to get aiternate bases from other user's catalogs. Note that the 
first and second elements in each of the sublists are the filename 
and the users catalog names respectively. The description of the 
GENCOMP procedure talks more about the ab parameter. Also see the 
note belows, at the end of this description on parameter tists. 
Procedure ASORT uses tists of lists to indicate the columns for the 
sort keys : 


seseasort izganips ozganops keysz{ (ls 5) (49 7s dd) 
Each sublist in the fist above is a singte sort key; the elements in 
the subtists are the start cotumns tengths and direction of sorte 


See the description of the ASORT procedure for more information. 


If you code onty one value for a parameters you can leave the 
parentheses offs like this : 


seseprint fzemyfile 


but as soon as you want to suppiy more than one value you must 
supply the parenthesess like this : 
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seseprint (bowmores juras mittown) 


Such are called gyiti valued parameters» or value Lists» or just 
piain fists. 


Referring to the discussion on the ab parameter of GENCOMP aboveys 
a few SES oprocedures handte parameters of that form. Those 
parameters are somewhat special forms for accessing files from other 
users’ catatogs»s for examptes the LINK170 procedure uses this form 
for the fist of ftibraries :;: 


seselink170 p=((tib_lstlib_2suser_L)slib_3sllib_4stib_5suser_2)) 


each element in the outer oparenthesised tist is itseif a tist 
(possibly containing only one etement) of JTibraries and the places 
to get them from. Sos in this examples the first sublist says : 
obtain tib.1 and tib_2 from the catalog of user_13 the second 
sublist has onfy gone elements which means : obtain tib_3 from the 
catalog of the current user; the thicd subtist says : obtain tib_4 
and §ib_5 from the catalog of user_2. For procedures that use this 
form of parameters the fast element in each of the sublists is the 
user name of the catalog from whence to obtain the files. 
Conversely : 


seselink1l70 pz(libils tibi2s 1ib_l3s tibl4s tib_5) 


means : obtain all five tlibrary files from the catalog of the 
current user. 
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12204 PARAMETER LISTS AS PARAMETER VALUES 


Some SES procedures handte multi valued parameters which are 
themselves parameter iists to be passed on to other procedures. For 
instances procedure FORMAT has a parameter called prints which is 
actually the parameters for the PRINT procedures used by FORMAT in 
the course of its rune You code the print parameter of FORMAT like 
this ;: 


seseformat myfiles orintzc=2 


seseformat hisfiles print=(cz=5,h='"final ers!) 


10225 PARAMETER KEYWORDS AS PROCEDURE OPTIONS 


Some SES procedures have parameters that don't want any values at 
all. In these cases» the parameter keyword is used to indicate 
QPIIGNS for the procedure. For instances procedure PRINT has a 
shift key (no pun intended)s which if codeds indicates that the file 
to be printed has not been formatted for a line printer and must 
therefore be “shifted™ to the right by 1 column and have carriage 
control characters added in (the new) first column. You use PRINT 
in such a case fike 3: 


seseprint fzanyfiles shift 
and another exampie of options is GENCOMP (GENerate COMPile file)» 
where you can type 3 
sesegencomp alls bzcidbases cfzcomfile 
in this cases the all key indicates that ALL modules are to appear 


on the resulting “compile file". 


Throughout the procedure descriptions», we use the word key to 
mean a keyword used to provide options to a procedure. 
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123 USING MORE _THAN_ONE_SES_ PROCEDURE _AT_A_TIME 


It's possibile to use many SES proceduress each one following on 
right after the previous ones with no execution breaks between 
them. You do this by coding them aif on the same tines each 
procedure terminated by a semicolons tike this ? 


seseprint myfiles noshift; print hisfifle shift; catlist 


This examptie PRINTs myfile and doesn't shift it (the noshift key)» 
PRINTs hisfite with carriage control added (the shift key)» and 
finally does a CATLIST of your files for you. 


124 ORDINARY. CONTROL_STATEMENTS_ON_A_CALL_IO_SE5 


It's also possible to include regular NGOS control statements on 
the same tine as SES procedure caliss ali mixed togethers tike 
this ; 


seseprint myfites; 'returnsmyfite’; *getshisfile*; format hisfile 


As you can sees the ordinary NOS control statements are enclosed in 
string delimiters just tlike any other character stringe When SES 
processes one of these contro! statement stringss it folfows the 
rule that ;: 


if the string doesn*t contain a period or a close parenthesiss a 
period is appended to the strings otherwise the string is teft 
alone. 


This means that you can place NOS control statements such as GTR 
and MODIFY (which use the controf statement comment field for 
directives) with no problems. For example 3: 


sese*attachsplocrib’'s ‘gtrspiocribsfred.**3; print fred 
In this examples the second NGS control statements namely the GTR» 
has a period in its so SES doesn't place any period at the end of 


the strings whereas SES does place a period at the end of the First 
string (the ATTACH statement). 
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1.5 CONTINUING SES_ STATEMENTS OVER MORE THAN ONE LINE 


SES can handie continuation tines (even when youtfre using SES 
interactively)» for those cases where you can't specify all you want 
to on one fines. You indicate continuation by placing two or more 
periods at the end of the line. SES then asks for continuation 
lines to be typed in. For example 3 


f‘seseprint fz=(snarks sharks charmeds gquarkss o-« 
ee? tarkss boojumss grogss banders snatchi) 


After you've signalied the incomplete tine by placing an ellipsis at 
the end of the tines SES prompts For a continuation tine with a eo? 
at the start of each continuation line. The slash {/) before the 
ses on the first tine indicates where NOS outputs Lts prompt for 
commands. 


When you use SES in a batch =Jjob stream you simply code the 
continuation lines one after the others each incomplete tine having 
the ellipsis at the ends for exampie 3 


batch 
job 
statements 
SESeCOLLECT (CHENASs FLEURIEs MORGONs CORNASs TAVEL» oo 
GHEMMEs SGAVEs ORVIETOs CAREMAs PARRINAs BAROLO) 
and more 


statements 
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1.6 PROFILE =_SETTING UP_YOUR_LOCAL ENVIRONMENT 


A PROFILE is a file where you can place information about you and 
the things youtfre currently working on. Many SES procedures use 
information out of the PROFILE to set up defauits for frequently 
used thingss such as the name of an object tfibrary. Having a 
PROFILE can save you much time since you don't have to code 
parameters for information that's already in the profile. 


If you want to have a profiles you should create a file cailed 
PROFILE which has the word PROFILE as the first tine of the file. 
The most important and useful pieces of information to place in your 
profile are your passwotd» charge number and project number. Thus» 
your initial profite shoutd have (at least) the following in it: 


PROFILE 

\ passwor = ‘your password? 

\ charge = tyour_charge_number ! 
\ project = tyour_project number * 


An easy way to set up an initial PROFILE for yourself is to call 
the BuilD PROFiltle (BLOPRQE) procedure like this 3. 


ses.bidprof 


BLOPROF prompts you for the most common items to be placed in your 
profile. In additions it creates a MAILBOX for youe For 
information on the “mail™ facilities of SES» see chapter 12.0 - 
"USER TO USER COMMUNICATIONS*, 


SES suppfies a procedure caited IAFs which sets up defaults for 
particular terminal types. BLOPROF prompts for your terminal types 
and places that information in your profile. For further 
information on IAFs see the IAF procedure description in the 
"miscellaneous useful goodies" chapter. 


BLOPROF wil! also ask you for your graphics terminal type which 
may be different than your usual terminal. Even if you use the same 
terminal for graphic (CADSG) and non-graphic works you should answer 
both requests. BLDPROF willl ask additional questions about your 
graphics terminal - baud rates hard copy availtables and for 
TEKTRONI X 4014 Extended Graphics Module and synchronous) or 
asynchronous. For further information on CADSGs see the CADSG 
procedure description in the Structured Process Tools chapter. 


There are many other things that may go into your profile. These 


COMPANY PRIVATE 


Se 2 BA 2G SE BO HO oD 


1-16 
CDC - SOFTWARE ENGINEERING SERVICES 
7/30/81 
1.0 INTRODUCTION 
1.6 PROFILE - SETTING UP YOUR LOCAL ENVIRONMENT 


EM Dit Bete Bn Bite Bid Det idee dd did Bee did GI i BM i Be Mi Be i Be Ri ie Bit Re ited ed Bid, dented Bo Aad 


are mainly concerned with source code maintenance and tibrary 
management functions and so one These other aspects of profiles are 
discussed in the chapters dealing with the specific subjects. 


Another useful thing that can go into a profite is SES directives 


that specify which procedure tftibrariess and wheres to search for 
procedures. The SEARCH directive is discussed in appendix A. 
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1.7 SES_PROCEDURES _RUN_AS_BAICH JOBS 


Instead of running interactivelys or "while you wait" at your 
terminals many SES procedures can be submitted to run in the 
backgreound as batch jobs. You do this by coding a key (batch or 
batchn or defer) which causes the framework of a batch job to be 
built around the specified procedures then SUBMITs the file so built 
to NOS as a batch job. 


Using SES in this way is often very effectives especialiy where 
the job to be done uses tots of resources. By running the job in 
batchs you can proceed with your interactive session instead of 
having to wait. 


For such proceduress the fist of parameters described below are 
those which affect the running of the batch job. Note that these 
parameters are only applicable if you run the procedure in batch 
mode {that iss non-local). 


jobun : 

(optional) JOB User Name to be used on the USER statement 
of the batch job. If you don't code the jobun parameters 
the job is built with the user name of the current user. 
Note : that in some NGS sitess it is not possible to 
SUBMIT a job to run under another user's account. The so 
called "secondary user" statment is disabited. If 
secondary user statements are disabieds and you try to 
subnit a job for another accounts you get logged off! 


jobpw 3 
(optional) J08B PassWord to be used on the USER statement 
of the batch job.j If you don't code the jobpw parameters 
and there's no passwor variable defined in your profile 
(see the section on profiles)s SES asks you for your 
password in a similar manner to that of NOS. 


“oe 


jobfaly 
(optional) J0B FaMiLY to be used on the USER statement of 
the batch jobe If you don't code the jobfmiy parameters 
and there's no family variabie defined in your profile 
{see the section on profiles)s the family name for the 
current user is used. . 
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joben 3 
{optional) J0B Charge Number to be used on the CHARGE 
statement of the batch job. If you don't code the jobcn 
parameters, and there's no charge variable defined in your 
profile (see the section on profiles)s SES asks you for 
your charge number, 


Jobpn 
{optional) JOB Project Number to be used on the CHARGE 
statement of the batch job. If you don't code the Jjobpn 
parameters and there's no project variable defined in your 
profile (see the section on profiles)» SES asks you for 
your project number. 


jobftl : 

(optional) specifies the JOB Field Length to be used for 
running the jobs. You don't normally need to code the 
jJobfl parameters since ali the procedures which run in 
batch set the FL to the required vatue» If you want to 
specify the job field tength as an octal numbers you aust 
add the (8) suffix to the numbers because SES treats 
numbers as decinal uniess told otherwise. 


jJobti : 

(optional) specifies the JOB Time Limit to be used for the 
Jobe This is always the same for ail procedures» namety 
2000(8). If you need more time for the jobs you must code 
some value for the Jjobti# parameter. If you want to 
specify the job time limit as an octal numbers you gust 
add the (8) suffix to the numbers because SES treats 
numbers as decimal unless told otherwise. 


jobpr : 
(optional) soecifies the JOB PRiority (that is» the P 
parameter on the NOS job statement). If you want to 
specify the job priority as an octal numbers you gust add 
the (8) suffix to the numbers because SES treats numbers 
as decimal untess told otherwise. 


bin 2 
{eaptional) BIN number parameter used at Sunnyvale 
Development Division to indicate which "bin™ the job output 
should go ine The bin parameter is coded in the form of a 
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strings for exampie : binz*7h*. You ican also define a 
userbin variable in your PROFILE {see the section on 
profiles), so that the bin number is picked up 
automaticalty. SES generates a large print banner of your 
bin number on the front of the job outputs and also places 
the bin number in the job name field of the job statement. 
If you don't code the bin parameters and there's no userbin 
variable defined in your profiles SES generates a bin 
number of NO-IDs which almost certainly guarntees that your 
job output ends up in the NOS/WO BIN NUMBER bin. 


focal or batch or batchn or defer : 

coding one of these (optional) keys determines the mode in 
which the procedure or job is to be rune. Coding the tocal 
k@y runs the procedure LOCAL to your terminalis or while 
you wait. Coding the batch key issues a SUBMIT with 
option 8B for the SUBMIT statement. Coding the batchn key 
issues a SUBMIT with the N option for the SUBMIT 
statement. Coding the defer key DEFERS the job for after 
hours running. You can find all the gory details of the B 
and N parameters for SUBMIT in the NOS reference manual. 


nodayf or dayfite or df : 
this {optional ) parameter applies to some of the 
procedures that can be run as batch jobs. Each procedure 
description (for procedures which can run as batch jobs) 
specifically mentions this parameter oniy if the procedure 
makes use of Ute For those procedures that do use its 
this parameter applies onty if the procedure is run as a 
batch job (that iss non-local). If you don't code the 
parameter at alls or if you simpity code dayfile or df» if 
the job hits an EXIT statement due to errorss the job 
dayfile is dumped to a fite called dayfiles which is 
placed in your catatog when the job terminates. If you 
code dayfiltezfilename or dfzfilenames the dayfile is 
placed in your catalog in a file of name filename. If you 
code the nodayf options no dayfite is produced at job 
ende The diagram below provides a more graphical 
explanation of the interactions of the dayfile parameter. 
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$e ee ee ee eee She ee ee ee eee + 
; Coded Qo : ; 
: Procedure ; Action Taken ; 
$e ee ew ee ee ee ee EE, + 
; Nothing ; Job dayfile is dumped to file dayfile if any 3} 
H 2 errors occur suring the Job. H 
$= ee ee ee ee fw a a ee + 
H dayfile or H ; 
‘ df key ; : 
; only ; Job dayfile dumped to file dayfile if any 
H 3 errors occur during ihe jobe ; 
$e we a ee ee fhe ee we ne a on ew ee ee + 
: dayfilezfite_name 3; : 
; or dfzfile_name | Job dayfile dumped to file file name if any 3 
; $ errors occur during ne job» ; 
Se ee me ee ee ee ee a ne ne She a + 
H nodayf key ; Job dayfile is not dumped even if errors § 
H } occur ager ing the job. H 
Se ee eo ee ee a ee ee SS A a SO Pe en ee a le + 


Note : that only those procedures whose descriptions contain a 
reference to the parameters described above can be run as batch 
jobs. 


Examptie of Batch Usage 


A fairiy widely used SES procedure is LISTMOD (which supplies a 
cross reference and a printout of the modules in a base - see the 
chapter relating to source text maintenance). LISTMOD runs “while 
you wait" by defaults and since it grindss it*s much better to run 
it batchs tike this : 


seselistmoed bznewdatas batch 
15.00.19. SUBMIT COMPLETE. JOQBNAME IS AFTQBXT 
* JOB LISTMOD SUBMITTED 


This example shows a simple usage of LISTMOD run in batch by ceding 
the batch key. The example assumes that your passwords charge 
numbers project number and ali are defined in your PROFILE as 
described earifer. The message is returned by NOS : it*s the time 
of day that your job was submitteds and the so called job name. The 
fast message about job submitted comes from SES. 
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1.7.1 PROFILE VARIABLES FOR CONTROLLING BATCH MODE 


SES procedures that can optionaily run in batch mode may be 
controtied by the settings of certain variables in your PROFILE. 
This makes it easier to use SES ati rounds since you don't then have 
to supply the information every time you use a procedure. The set 
of dicecstives below can be coded Into your profile if you wish. 


PROFILE 

\ passwor = "your password? 

\ charge == "your charge number? 
\ project = "your project number !? 
\ family = "your _famity' 


passwor defines your password 

charge defines your charge number. 
project defines your project number. 
family defines your family name. 


Note : that if your vaiidation on the system is such that you do 
not require a CHARGE statement in batch jobs or when you tog in at a 
terminals you should set the charge and project variables to null 
{empty) strings. This Inhibits the generation of the CHARGE 
statement by SES for batch jobs. 
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Examples of PROFILES 


PROFILE. 

\ passwor = *"ASTERIX# 
\ charge = 'OBELIX® 
\ project = "GETAFIX® 


That is an example of a minimal PROFILE. Here's a typical PROFILE 
as it might be defined for a user at Sunnyvale Development 
Division 3 


PROFILE 

\ passwor = "'WABBIT*®. 

\ charge = #* 

\ project = #* 

\ userbin = *21€* 

\ myname = tlLorenzo Desmondo 0'*Haret 


Note that the charge and project variables are set to empty strings 
-~ at the time of writings SDD doesn't require CHARGE statements on 
NOS. 
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1-8 INEQRMATIVE MESSAGES EROM_SES_ PROCEDURES 


Many SES procedures are set up such that when they run "while you 
wait™ at the terminals they output informative messages to tefl you 
what they're doinge The informative messages are controlied by gsqg 
and nomsga Keys on the appropriate procedures. The normal default» 
in the absence of any other information is for the procedures to 
output informative messages. Coding the nomsg key suppresses the 
messagese Howevers it is possible to establish your own default by 
defining a profife variable called msgctri. The msgctrti variable 
can be defined in one of two ways 3 


\ msgcetri = !! this sets the normal default for informative 
messages to no messagese In order to obtain 
messages from procedures the msg key must be 
coded on the procedure call. 


\ msgetri = *SESMSG.** this sets the normal default to output 
informative messages. To turn messages of Fs 
the nomsg key must be coded on the procedure 
call. 


The table below should give a more graphical idea of the 
interactions of the msgctril variable and the msg and nomsg keys on 
the procedurese 


Se me ae a a a ce oe te ae a ea a ee ae a a Na mn + 

i DEEINED IN PROFILE ; 

$n oe wee ee $$ + $e a nn nw oe oe ee ooo + 
H Coded Qn i: Nothing : \ MSGCTRL="SESNSG.** ; \ MSGCTRL=9** 3} 
+ Procedure 33 : : : 
ooo oS $a a ee ee $e wee eee een eee + 
+; Nothing +: Messages : Hesse ors H No Hesseges ; 
$awewe ---- a $2 eo ee ee $e enn ne ee ee + 
: MSG 3 i edesincoedes H Messages H Nessages ; 
wr a nn a ff He rn ne $n eo nw ee $n ne ew we eee + 
: NOMSG 33 No ; No Messages H No Neccages H 
; +: Messages } : H 
$e ee ee $ 4-2 = + $n a a ne oo + 
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1.9 GENERAL_NOTES_ON_SES_ PROCEDURES 


SES procedures ares in generals written to do the detail work for 
yous so you can concentrate on the job at hand. Let's took at the 
workings of a typical SES procedure - COPY ASCII Coded Record 
(COPYACR)»s to see what it does 3 


sesecopyacr izinput_ files osoutput_file 
* END COPYACR INPUT_LFILE -> DUTPUT_FILE 


The COPYACR procedure emits NOS controt statements to do the 
following : 


acauice the input _file (see the note on ACQUIRE below) 
acguire the program (too!) that does the COPYACR process 
ceturo the output file 

COPYACR from input _file to output_ file 

ceturn the COPYACR program 

Cewiond both the input file and the output_file 


you may if you wishs use procedures such as COPYACR like this : 


sesecopyacr file _to_be_ processed 
* END COPYACR FILE. TO_BE_PROCESSED 


In such casess where does the output of the procedure go? Well it 
certainly doesn*t go to file output (the terminal). In such casess 
the output file eventually reptiaces the input file : 


acguire the file_to_be_processed 
acquire the COPYACR program (tool) 
COPYACR file_to_be_processed to a unique_named_temp_file 
ceturn the COPYACR program 

* cenape file_to_be_processed = unique _named_temp_Ffile 
cewind unique_naned_temp_file 


There are many SES procedures that function this way - they are 
often referred to as FILTERS - a process that copies an input to = an 
output with some {one would hopes useful) transformation in 
between. 
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ACQUIRING Eiles_in_ SES Procedures 


When you call up an SES procedure to 3 
sesedo_some_process izinput files ozoutput_file 


one of the controfi statements emitted by the procedure is a 
statement to ACQUIRE the input files which means ? 


1. if there's a LOCAL file of the required names REWIND that File 
and use it as the input file. 


2e otherwise AITACH or GEI a permanent file of the required name 
from the current user's catalog. 


All this means you don't have to care whether or not fites are 
focai - SES procedures grab whatever is avaitable under that name - 
that is what ACQUIRE is all about. There is a full description of 
the ACQUIRE utitity in Appendix E. 


The foregoing has some interesting effects which you shoutd be 
aware of however. Consider the following sequence 3: 


ses.files; cattist 
WORKeos eeel2 PT. 
CATLIST GF WCN ( 9 FILESs 2685 PRUS ) 
MAILBOX I SP A eeel OGLOUSER D PU R 1127 PNTSORS D PU R 2.105 
PROCLIB D SP R 124 PROFILE I PR R oeel PROGLIB D PU R .835 
SEVENee I PU R eee2 STATSES D PU W .485 USERDIR I PU R ened 
* END CATLIST 


sesepack izstatses 
* END PACK STATSES 


sesefiles 
WORK eee eosl2 PT. STATSES «+481 LO. 
* END FILES 


Note that we PACKed file STATSES. Note that originatlys STATSES 
was a PERMANENT DIRECT ACCESS file. By the time the PACK process 
finished however, the PACK procedure {because of the RENAME process 
described earlier) has now fteft a LOCAL file of the same name. SES 
procedures don't,» in generals rewrite permanent files. Those that 
do say so explicitty. 
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Using SES Procedures in. Batch 


If you followed the description of the behavior of SES procedures 
aboves you may take note that SES is designed primarily as an 
INIERACIIVE tool. You can use SES in batch job streams if you wishs 
but you should be aware that SES procedures don'ts in generals make 
a special case of files INPUT and QUIPUITs» whereas NOS does make a 
special case of files INPUI and QUIPUT. Usuallys when using SES 
procedures interactivelys you don't use QUITPUT as the output file 
from proceduress those procedures that do use INPUT or QUIPUT say 
sos and take special note of those files. Ali this means that if 
you run SES in batch streamss and use files INPUT or QUIPUT as input 
or output to procedures» you're tikety to tose a tot of output 
because SES procedures REWIND or RETURN things. Sos to avoid griefs 
uses files other than INPUT and QUIPUT. 


Unigue _Names_io_SES erocedures 


When SES builds the JCL stream from an SES procedures programs» 
scratch files and so on are usually given unique names» so that you 
don't have to care which names are reserved by each particular 
procedure. These SES generated unique names are always seven 
characters longs always begin with the tetters ZQs and are aiways 
guaranteed to be different from the name of any file currentty 
assigned to the running job. This note is for your informations 
just in case you ever took at a dayfite where SES procedures have 
been useds and see tots of funny looking names.» The example below 
shows the JCL generated by the seselimits procedure. 


$RFL(20000) 

STFC FILECQGUTPUTs AS) SRENAME( ZQWT8Q6=0UTPUT) 
SASSIGN(MSs OUTPUT) 

$LIMITS. 

SRENAME(ZQWTSQQ20UTPUT) 
SIFCFILECZQWT8Q69AS) DSRENAME (OUTPUT =ZQWT8Q6) 
SREWIND(ZQWTBRA) 

EDT( ZQWTBQQs ZQWTSRAs ZQWTSRW) 
SRETURN(ZQWTBRAs ZQWT SRW) 

SCOPYBR(ZQWT8QQs OUTPUT) 

SRETURN(ZQWT8QQ) 

$RFLCO). 

* END LIMITS 
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1.10 PROCEQURE_ DESCRIPTION CONVENTIONS 


The remaining chapters of this handbook describe SES procedures 
that are currently avaitable. Each procedure description contains a 
fist of parameter descriptions; and the order in which the 
parameters are described specifies their positional significance 
within the procedure. 


Onty those procedures that make references in their parameter 
listss to the “batch job parameters" {see section 1-47 - "SES 
PROCEDURES RUN AS BATCH JOBS") can in fact be run as batch jobs. 


If a procedure description does not contain a description for a 
parameters that procedure does not have such a parameter. 


If a parameter description does not explicitiy specify that a 
parameter Is optional then the parameter must be supplied when the 
procedure is catled. 


In order to reduce redundancy within procedure descriptionss some 
of the features provided by a procedure are discussed in the 
descriptions of particular parameters; therefores we strongly 
recommend that when you read a procedure descriptions you read the 
whole thing. 


Before you read a particular procedure descriptions we strongly 
recommend that you read the introductory subsection of the chapter 
containing the procedure description. Such things as general 
parameter descriptionss profile usages and naming conventions are 
discussed in those subsections. 
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1.11 HELP_MODE 


SES provides a mode of operation of procedures that produces 
descriptive information about the specified procedure. The 
information includes a one or two sentence description of what the 
procedure does plus a list of the parameters, their defaultss and 
the permissable values. In additions required parameters are 
"filiagged™” with (RP and defaults that are controilable by PROFILE 
variables are "flagged" with an *. To get the help documentation 
for a procedure tisted out on your terminals you simply type : 


sesshelp.procedure_name 


Notice that no parameters are given. SES responds by displaying the 
help documentation for the named procedure (if any is availabie). 
For exampte 3: 

sesshelpecybil 
produces 3. 


CYBIL compiles CYBIL source using either the CC or CI compiler. 
Parameters are: 


~--P ARAMET ER @-<---mo--- DEFAUL Tw---——---ALLOWABLE VALUE(S)--- 
isf COMPILE filename 
{ LISTING filename 
b LG6O filename 
ccs ci *CC=SES keywordzusername 
chk NsRoS Nefss or no 
fo I CefsOsismswor 
debugsdsnodebug NODEBUG keyword or (STs)0S) 
pad none l «ee large reasonable number 
opt 0 O or 1 (CI onty) 
MSGsNomsg *MSG : keyword 


“HELP FOR CYBIL ON FILE OUTPUT- 


Note : that heip mode is not tntended as a training mechanism or 
a tutorial for new SES users - that's what this SES User's Handbook 
is for - hetp mode is there as a “memory jogger™" for more 
experienced SES hackers. 
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1.12 PRE-RELEASE _VERSTONS OE_TOOLS 


SES provides a convenient and consistent method for accessing 
pre-release verstons of SES supplied tools. To access the 
pre-release version of a procedures you simply type : 


S@syssseprocedure_name list _of parameters 
If there is a pre-release available for the specified tools it 
executes. If there is no pre-release versions you get the standard 


release versions 


If you always want ore-reltease versions of toots that are 
availables you can piace in your PROFILE the following directive : 


\ SEARCHs USER»s SSS» SESUNAM. 
This teftts SES to first took in the current user's catalog for the 
specified procedure (just as normally happens)s then took in the 
pre-release catatog (358)» and finally took in the standard release 
catalog (specified by the SESUNAM variable). 


A more detailed description of the SEARCH directive can be found 
in appendix A. , 
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1213 PROBLEM REPORTING 
Probtems encountered while using a released SES tool should be 
reported using a PSR (Programming System Reports CDC form AA1901). 
Problems encountered while using a pre-released SES toot shouid 
be reported using a PTR (Programming Trouble Reports COC form 
AA3385). 


In both cases the completed form atong with ali support materiaits 
should be sent to the Arden Hills PSR Coordinator (ARH273). 


COMPANY PRIVATE 


1-31 
CDC - SOFTWARE ENGINEERING SERVICES 
7/30/81 
ree ae SES {Release - i7) User*s H Handbook . REV: AB mam 
1.0 INTRODUCTION 
1. 214 APPLICABLE | DOCUMENTS 


a Mae Mh Bina PE PO PO OE BAPE PT PE PE OE PE 20 18 18 98 88 8 18 OO 8 RO OE P08 88 PETE OD PE 88 98 08 D8 PE OE PO OE PR Pt 88 FE PE 98 00 28 08 88 PA 98 PEE 


1.14 APPLICABLE DOCUMENTS 


The following is a tist of documents describing the various tools 
supplied by SES. Note ;: that SES provides a procedure calied 
TOOLDOC which provides "on-fine™ access to many SES documents. If 
you calf TOOLDOC without giving any parameters» you get a tist of 
the available OCS documents. 


$$ we ow ee $e eee $e nn ee ee ee ooo $e nnn eee + 
: Tool : Ver + Document Type : DCS Naabe: : Updated ; 
$e ee ee eee pone $e eee ee ee ee ee $< eee eee $e nnn wee + 
; SES Tools $ ~~~ ? User Handbook ? ARH 1833 H 07/31/81 ; 
; SES Processor ; 1.1 3 User Guide s ARH 2894 : 05/29/79 3% 
; EDT $ --- } See SES UsaHes ; H ; 
; EXTRACT $ --- {| See SES U.H. ; H H 
+ SESMSG +; ~~~ 3 See SES U.H. H H H 
$ TXTCODE + 220 }: User Guide i ARH 2893 : 02/21/80 3} 
3: TXTFORM + 1.5 ¢ ERS + ARH 1737 3 06/01/77 $ 
$ TXTHEAD 3; ~~~ | See SES UH. H H H 
§ GENREVP $ =-j—— } See SES UH. ; H ; 
: CADS DD Tool $; 1.0 $ User Handbook ¢ ARH 3980 3; 03/30/81 ¢ 
$ CADS Graphic Tool $ 1-0 i User Handbook } ARH 3981 $ 03/30/81 $ 
' CYBIL + 220 ${ Language Spec +} ARH 2298 3; 06/18/81 i 
; CYBIL +; 220 } IeDe Handbook ¢ ARH 3078 $ 06/18/81 $ 
: CYBIL Formatter + 0.0 3 ERS : ARH 2619 $ 05/14/81 $ 
: CYBIL Debugger > 120 $ ERS } ARH 3142 3; 09/29780 $ 
: CYBIL I/D : 1.0 3 ERS : ARH 2739 : 07/18/80 $ 
+ Sime NOS/VE 1/790 $ 1-0 $ ERS $ ARH 3125 > 01/25/80 3; 
+ C180 CPU Asmb. + 2e2 + ERS § ARH 1693 : 02/18/80 $ 
: C180 PPU Asmb. stom $ ERS : $2501 : 03/07/78 3 
; SES VE Linker $s 204 $ ERS + ARH 2816 £ 02/18/80 3 
+: SES VE Generator 3 1.1 3? ERS + ARH 2591 3 02/18/80 $§ 
+ C070 OCU + 2020 $ ERS $ ARH 2922 $ 07/18/81 % 
; C180 Simutator + 520 3 ERS ; ARH 1729 : 03/02/81 $ 
; PSEUDO + 3.0 : User Guide ; ARH 2892 + 05/29/79 3} 
:; $SCU (170) $ 12.0 ? ERS : ARH 1766 $ 05/21/80 $ 
$e wenn wo ww one ee eee t-—--~ ooo $ ween eee enn $m m nee nen + 
SES UeHe refers to this document 

SES PeWeGe refers to the SES Procedure Writer*s Guide (referred 


to above as the SES Processor User Guide -- ARH 2894) 
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The following CDC manuais for NOS/170 may be of help to users of 


SES. 


60435409 
60445300 


60455250 


60435509 
60450100 
60492600 
60328800 
60497809 
60429800 


60481409 


NOS Version 1 Reference Manual (Volume 1) 
NOS Version 1 Reference Manual (Votume 2) 


Network Products Interactive Facility Version 1 
Reference Manual 


NOS Version 1 Time-Sharing User's Reference Manual 
NOS Version 1 Modify Reference Manual 

COMPASS Version 3 Reference Manual 

SYMPL Reference Manual 

FORTRAN Extended Version 4 Reference Manual 

CYBER Loader Version 1 Reference Manual 


CYBER Interactive Debug Version 1 Reference Manual 
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200 PRINTING_EILES 


This section covers the facilities for printing files. Most of 
the discussion revotves around the ASCII printers and the SES 
procedures to use the ASCII printer are as described below : 

PRINT prints file(s) on the ASCII printer (the “normai®™ CDC 
printer is an option). If necessary» "carriage control™ is 
added to the files before printing {it is possibie to 
override this automatic determination but it is very seldom 
necessary to do so). Choices of character sets (full ASCII 
or the 64 character ASCII subset) are available. 


PRINTID places “large print" heading banners at the start of a 
printout. Lines of titles, date and time formatss and 
number of banners are selectable. PRINTID is used by PRINT 
to (optionaily) place ftarge print banners at the start of 
the filets) to be printed. 


COPYSAF COPY Shifted ASCII Eile. Caoptes an ASCII file to prepare 
it for printing at a later stagee The file is "shifted" if 
necessary. Character set conversion is atso performed = as 
required. 


BANNER piace "large print™ banners of your bin number on the front 
of ae printout. BANNER is used at Sunnyvate development 
division where output is piaced in “"bins™s identified by a 
bin number. 
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2e1 PRINI_.=.2RINT_EILELS) 


PRINT is a powerful facility for printing one or more file(s). 
It ftooks after the mundane matters of character set conversions» 
special disposition (route) codes ands perhaps most importantly» 
automatically determining whether each file to be printed has 
already been or needs to be "formatted" for a printer. 


f or F 2 
specifies the name of the Files or a tist of files to be 
printed. If the filets) are not already tocal when PRINT 
is cattleds, PRINT tries to GET or ATTACH the filets) for 
youe 


copies or c or n ? 
{optional) specifies the Number of Copies of the printout 
you require. If you dontt code the c parameters PRINT 
produces 1 (one) copy. 


h or id 2 
loptional) specifies the Heading banner to be printed at 
the start of your printout. If you dontt code the h 
parameters the first two pages of the printout will have a 
"farge print™ banner of the file names date and time. 


hn or idn 3. 
{optional) specifies the Number of Heading banners to be 
placed at the start of the printout. If you don't code 
the hn parameters PRINT produces 2 (two) heading banners. 


shn or sidn : 
{optional) this parameter is used when printing more than 
one file at a time. When a fist of files is printeds 
PRINT outputs a heading banner for the whole printouts and 
places a sub heading before each new file is started. The 
shn parameter specifies the Number of SubHeading banners 
to be printed before each new file. If you don't code the 
shn parameters PRINT produces 2 (two) subheading banners. 


printer or pr : 
this {opttional) parameter specifies on which printer the 
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220 PRINTING FILES 
2el PRINT - PRINT FILE(S) 
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bin ? 


setid 


compres 


printout is to appear. If you don't code this parameter 
or if you specify asciis the printout is routed to the 
Full ASCII printer. If you specify ascii64s the printout 
is routed to 64 character ASCII subset printer. If you 
specify cde» the printout is routed to a "normat™ CDC 
printer. Any other value for this parameter is itiegal. 


If you tive at Sunnyvate Development Divisions printout 
needs some sort of a banner containing a Bin Numbers to 
tell operations which bin to place the output ine 
Printouts without a bin number frequently end up in a bin 
fabelied NOS/WO BIN NUMBER.~j At the time of writings all 
bins have identifiers of the form digit digit Letters» which 
means you must code the bin parameter in the form of a 
strings for examples binz=*22a*. The string delimiters are 
required If you don't want SES complaining about invatid 
numbers. If you don't code a bin parameters PRINT uses the 
value of profile variabie userbins and if there's no such 
profite variable defineds generates a listing banner of 
NO-ID» which almost certainty guarantees that your output 
goes to the NOS/WO BIN NUMBER bin. The bin parameter iis 
net available at Arden Hills. 


setid is another Sunnyvale special. [If your printout jis 
destined for the "normal™ (printerzcdc) disolay code 
printers not the ASCII printers and if your printout is 
large (more than about 100 pages)s please be nice to 
operations and code setid=6 or just plain setid 6. Printer 
id 6 is for tong print runss so be good to the wortid at 
large {including yourself) and use printer 6 for tong 
printouts. 


H 

(optional) keyword specifies multipie copies are printed 
together on one tisting with onty one NGS banner. When 
compres is used the number of heading banners is defaulted 
to zero uniess overridden by specification of values for hn 
or shn. 


cs6l2 or cs64 or cs812 : 


these (optional) keys can be used to specify the character 
set of the file(s) to be printed. If you don't code any 
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220 PRINTING FILES 
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of these keys or if you code the cs612 keys the file{s) is 


{are) assumed to be in the NOS 6/12 ASCII character set. 
If you code the cs64 keys the file(s) is (are) assumed to 
be in the 64 character ASCII subset or display code 
character set. If you code the cs812 keys the file(s) is 
(are) assumed to be in the "8 out of 12” ASCII character 
set. 


shift or noshift or cmps : 


date or 


time or 


these (optional) keys control whether the printout is 
SHIFTed before disposal to the printer. If you don't code 
any of these keys» PRINT examines each file to determine 
how to prepare it for printing (i.e. which of these keys 
should have been selected). Note : that this automatic 
determination works for the vast majority of files and 
that this parameter is provided for use only in those rare 
cases where the automatic method fails. Note alsos that 
the option you select with this parameter applies to all 
files to be printeds and therefore in the automatic case a 
mix of "shifted" and “unshifted"™ files can be printed with 
one procedure call. If you code the shift keys PRINT 
shifts (i.e. adds "carriage contro!" characters at the 
left of each tine) each File in order to "format" the 
fite(s) for printing. If you code the noshift keys PRINT 
assumes each file is already "formatted™ for printing and 
therefore does no shifting. The cmps key is a special 
form of noshifts where any tine that contains gonly al in 
column one is deteteds and any tine starting with an 
asterisk (*) In column one is also defteted. This is 
intended for printing the output of programs such as 
COMPASS and CATALOG which try to print on "prime pages". 
This idea is out of date these days» and the cmps key 
helps save paper. 


etad ; 

this {optional) key specifies the form in which the DATE 
is to be output on the banner. If you code the date key» 
PRINT uses the form O1 AUGs 785 which is the defauit. If 
you code the etad keys you get the standard system date 
format. 


ampm 3 

this (optional) key specifies the form in which you get 
the TIME on the banner. If you code the ampm keys PRINT 
uses the form 42323 PMs which is the defauit. If you code 
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the time keys» you get the standard system time format. 


Examples of PRINT Usage 
seseprint ({myfiles hisfiles herfite) 
* END PRINT MYFILE.~eHERFILE 
This example prints three files : myfiles hisfile and herfite on 


the ASCII printer. The example shows the message that appears at 
the end of the print process. 


seseprint formouts c=#3s noshift 
* END PRINT FORMOUT 


This exampie prints three copies of the file formout without 
shifting the file (the noshift key). 
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PROFILE Variables _for_PRINI 


If you wishs you may establish default options for PRINT by 
setting variables in your PROFILE. The profile variabies that print 
uses are defined here, 


copies default number of copies to print. 


hn default number of heading banners to print at the start of 
a printout. 


shn default number of subheading banners to print at the start 
of every file in a multi file printout. 


printer default printer to be used. Refer to the printer oarameter 
in the procedure description above. 


incset default character set of filets) to be printed. Refer to 
the es612 parameter described above. 


shift sets your default for shifting files or not. Refer to the 
shift key description above. 


userbin used onty at Sunnyvale Development Division. userbin sets 
up your default bin number. 


In addition to the profile variables described aboves there are 
profile variables that PRINTID uses. See the description of these 
at the end of the PRINTID procedure description. 


Note >: because the userbin profile variable is used by PRINTs it 
is aiso used indirectly by any SES procedure that uses PRINT. 
userbin is also used by those SES procedures that can run in batch. 
If you run procedures in batchs userbin is used to place bin number 
banners on the batch job output. 
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202 PRINIID.=_PRINT_ "LARGE PRINTS HEADING BANNERS 


PRINTID is mainty used as a buitding biock for other procedures. 
It produces a “large print™ heading banners that occupies ae full 
pages using a program catied JOBID which is described in an appendix 
to this document. Parameters to PRINTIOD are 3 


h or id 3 
this parameter may be any arbitrary character string which 
specifies the text to be output. The string used can be 
anything that's tegal for the JOBID program. 


copies or c or nor hn or idn ;3 
{optional) Number of COPIES of the banner that you want 
output. If you dontt code the copies parameter» PRINTID 
produces two (2) copies. 


o or output ; 
(optional) name of fille to which the banner is to be 
Output. If you don't code the o parameters PRINTID uses 
file OUTPUT. 


date or etad : 
this (optional) key specifies the form in which the DATE 
is to be output on the banner. If you code the date keys 
PRINTID uses the form 01 AUGs 785 which is the default. 
If you code the etad keys» you get the standard system date 
format. 


time or ampm ;: 
this (optional) key specifies the form in which you get 
the TIME on the banner. If you code the ampm keys PRINTID 
uses the form 4323 PMs which is the default. If you code 
the time keys you get the standard system time format. 


cs6l2 or cs64 or c¢s812 3 
these (optional) keys specify the character set in which 
PRINTID output is to appear. If you don't code any of 
these keys or if you code the cs64 keys output is in the 
64 character ASCII subset (can aiso be thought of as 
disolay code) character set. If you code the cs612 key» 
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output is in the NOS 6/12 ASCII character set (since 
PRINTID output does not include any of the so-calied 
extended characterss cs612 is effectively equivalent to 
cs64 for this procedure). If you code the cs812 key» 
output is in the "8 out of 12” ASCII character sete 
Nate_: that when PRINTID is caited by the PRINT 
procedures that this parameter is set according to the 
destination printer; the PRINT procedure has a parameter 
with these keys and it refers to the character set of the 
file(s) to be printed. 


Note that the date and time parameters only have effect when the 
bh parameter is specified as aname.e If you give the h parameter as 
something other than a names it is up to you to inciude the date and 
time in the heading if you want it. 


Exampte of PRINTID Usage 
seseprintid idz=*final/debug/document'»s ozbanner 


¥ END PRINTID BANNER 


This example shows a titte banner being formatted onto ae file 
caltted banner. 
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PROFILE _Variables.for_PRINIID 


You can establish defaults for various PRINTID parameters by 
coding them In your PROFILE. The profile variables are described 
here. Atso refer to the PRINT profile variabtes. 


myid is a character string specifying the default format § for 
heading banners. For complete understanding of the 
following description refer to the documentation for the 
J53BID program (which produces the banners) and to the SES 
Procedure Writer's Guide. 
The default heading banner format would be defined via this 
profile variable as follows : 


\ myid =884/tteeyVaAlSth) e887 7) tt temydatet++?*//)tttemytime® 


Other heading banner formats can be constructed In an 
analogous manner. To eliminate heading banners altogether 
(as the default case) you should code the following tine in 
your profile ;: 


\ myid = NO 


Note that in order to produce a heading banners the length 
of the string assigned to the myid variabite must be at 
least 4 (four). 


mydate is a character string containing your version of the date. 
Refer to the date key in the procedure description above. 


mytime is a character string containing your version of the time. 
Refer to the time key in the procedure description above. 


outcset can be used to specify the default character set § for 
PRINTID output. Refer to the ¢s6& key in the procedure 
description above. Note that this variable has no effect 
when PRINTID is being catied by the PRINT procedure. 
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COPYSAF oprepares ai filte for printing on the NOS ASCII printer. 
The file in question is converted to the ASCII8 character set If 
required, and shifted (carriage controt added) if required. 
Parameters to COPYSAF are : 


ior f 3 
name of Input Eile to be prepared for the printer. 


(optional) name of file to receive the Qutput from 
COPYSAF. If you don't code the o parameters the output 
appears on the file specified by the i parameter. 


incset or ic : 
{optional) designator for the INput file's Character SET. 
The table below describes the allowed designators. 


outcset or oe : 
{optional) designator for the OUTput filets Character 
SET. The tabte below describes the allowed designators. 


shift or noshift or cmps : 
these (optional) keys control whether the printout is 
SHIFTed before conversion. If you don't code any of these 
keys» COPYSAF examines the file to determine how to 
prepare it for printing {that iss which of these keys 
should have been selected). Note : that this automatic 
determination works for the vast majority of files and 
that this parameter is provided for use onty in those rare 
cases where the automatic method fails. If you code the 
shift keys COPYSAF shifts (that iss adds “carriage 
contro!™ characters at the teft of each line) the file in 
order to "format" the file for printing. If you code the 
noshift key» COPYSAF assumes the file is atready 
"formatted” for printing and therefore does no shifting. 
The comps key is a special form of noshifts where any line 
that contains only al in column one is deleteds and = any 
fine starting with an asterisk (*) in column one is also 
deleted. This is intended for printing the output of 
programs such as COMPASS and CATALOG which try to print on 
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"orime pages". This idea is out of date these days» and 
the cmps key hetps save treese 


The incset parameter has a default of cs612 (NOS 6-12 character 
set) and the outcset parameter defaults to ¢s812 (ASCII character 
set suitable for the NOS ASCII printer)s as described in the table 
belows but these defauits can be overridden by defining in your. 
profile defaults via variables with names the same as the 
parameters. The following table defines the allowed designators for 
the inecset and outeset parameters : 


Fe ee cee ee ec an ae a a oe a a ee a a a ae ne ee ne + 
: ; : 
H Desiagnator H Meaning H 
8 a a 
a 2 3 
pe ee oe ee oe ee om ee oe ee ee cae a ee ee ce 00 eee eS Oe SE NS EE A A A SO + 
; : ; 
H cs612 : NOS 6/12 ASCII character set ; 
4 b 2 
% 4 a 
E eenheed ah SS Ne ERD -amDe ens ENED SRD amt GD AOD ee ea a ce ew ee ee eee ee ee ee ee ee ee an > 
3 H ; 
H cs 64. $ 64 character ASCII subset (display code) } 
H s character set : 
: : ; 
Sp ee ee ae ae oe nt cae eo ee ae ne eee ae ee ee ee a a a A NS A A SN SR as + 
H ; H 
H cs812 ; "8 out of 12" ASCII character set H 
a E 2 
1 3 a 
+ + + 


AAD GD GED he AED AR OR RD SD OD ee em a ee EP ED DD SS EE NP ED ED EE TR ED EE ED ED A AE A RT GE ED ED ED EE ND DD EE i 
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Examptes of COPYSAF Usage 


‘sesecopysaf tistings topresss noshift 
* END COPYSAF LISTING => TOPRESS 


sesecopysaf outfiles cs64 
* END COPYSAF OQUTFILE 


The first example of COPYSAF converts the file listing from the 
b-12 character set to the 8-12 character sets placing the result on 
file topress. The noshift key ensures that the file is not shifted 
during the conversion. The second exampte is converting a display 
code fiite to the 8-12 character set ready for printings and COPYSAF 
determines whether to add carriage contro! to the file. 
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2°4 BANNER _=_ WRITE BIN _NUMBER_ON_ LARGE PRINT BANNER. PAGE 


This procedure is a special form of the PRINTID procedure for use 
in Sunnyvale to identify printed output. 


BANNER is intended for writing the user's bin number on aie targe 
print banner page (factually it produces two pages of banner) on 
printouts or in the dayfile of a batch job. BANNER produces two 
pages with your bin number arranged in a geometrical pattern that 
makes it easy for the process control persons to sees BANNER 
outputs the page in different patterns depending on the number of 
characters in your bin number. Parameters to the BANNER procedure 
are 3 


bin ; 

is your (optional) bin number. This must be specified in 
the form of a strings for examples bin='018d?", If you 
dontt code the bin parameters BANNER uses the vatue of 
profile variable userbins and if there's no such profile 
variable defineds generates a bin number of NO-ID which 
almost certainly guarantees that your printout ends up in 
the NOS WITHOUT BIN NUMBER bine 


© or output °: . 
is the (optional) name of the File on which the banner is 
to be written. If you don't code the o parameters the 
banner appears on file output by defaults making this a 
convenient default for batch jobs. 


Exampies of BANNER Usage 


sesebanner 
* END BANNER 


sesebanner binz*13b'*» o=tempout 
* END BANNER TEMPOUT 


The first example shows the simpfest use of BANNER with the 
banner going to file outputs and the bin number either obtained from 
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the userbin variable in the profiles or the default NO-ID 
generated. The second example shows how to code the bin number 
parameter on the procedure fine. 


PROEILE Variables for BANNER 


The onty PROFILE variable used by BANNER is : 


userbin defines your output "bin™ identifier as a character 
string. 


Note ;: that the userbin profile variable is aiso used by PRINT» 
and thus indirectiy by any SES procedure that uses PRINT. userbin 
is aliso used. by those SES procedures that can run in batch. If you 
run procedures in batchs userbin is used to place bin number banners 
on the batch job output. 
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300 DOCUMENT EQRMATTING SYSTEM 


The documentation formatting system is a powerful set of programs 
that can produce documents from unformatted source texts containing 
directives to control margin alignments» itemisings tables and so 
One There are facilities to compare two versions of a document to 
generate revision bars to indicate changess and facilities to change 
heading formats and so on. 


The major components of the documentation system are two 
processors catied TXTCODE and TXTFORM. TXTCODE is in fact a high 
fevel preprocessor for YTXTFORM. See the "Applicable Documents" 
section of this document for the manuats that describe TXTCODE and 
TXTFORM, ; . 


After the main descriptions of FORMAT and FORMREVs there are a 
number of "data Fiow diagrams™ showing the processes that are run by 
coding different parameter combinations on a FORMAT or a FORMREV 
procedure usagee 


FORMAT runs the comptete document formatting system in all its 
manifestations and optionss white the rest of the 
procedures described after FORMAT are the individuat 
components of the system. 


FORMREV runs’ the document formatting system to generate a revision 
packages complete with change pages and change directive 
summar ye 


SPELL produces a list of suspected misspelied words from a text 
file. 


TWOPAGE places two formatted document pages on one printer page. 


DIAGRAM aids the construction of block diagrams such as those found 
later in this section. 
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320 DOCUMENT FORMATTING SYSTEM 


MEMO 
TXTCODE 
TXTFORM 


TXTHEAD 


GENREVB 


GENREVP 


produces a standard format memo. 


runs the high level preprocessor for TXTFORM. 


produces a formatted document. 


a TXTFORM post processor which changes heading banners on 
document pages. 


works in conjunction with TXTFORM to format a document with 
revision bars down the right side of the page to show 
changes from a previous document. 


builds a revision package by comparing the output of two 
formatted documents. 
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FORMAT produces a formatted document either from TXTCODE source 
(the default)» or from TXTFORM source. FORMAT normally runs in 
batch rather than interactivelys but you can run FORMAT at the 
terminal if you wishs by coding the tocal key when you run ite It 
is usualiy better to run the document formatters in batch since they 
consume some time. Parameters to FORMAT are 32 


ior f 3: 
name of Input File containing source data to be formatted 
by TXTFORM or TXTCODE. 


b or old ? 
(optional) name of file containing a Base or OLD version 
of the document source. If you code the b parameters 
FORMAT compares the files specified by b and # such that 
revision bars are printed on the formatted output 
document. 


f or fisting : 
(optional) name of File to receive the output of the 
formatter in a form suitable for printing on the ASCII 
printer. If you don't code the 4! parameters and youre 
running FORMAT LOCAL at your terminals the output appears 
on a file catted tisting. 


d or display : 
(optional) name of file to receive the output of FORMAT in 
a form suitable for DISPLAYing at a terminals that iss the 
formatted document is truncated for a terminal screen. If 
you don't code the d parameters FORMAT doesn#t produce any 
display file (untess you code the k parameter described 
below). 


batch job parameters : | 
These parameters are described in section 1.7 - "SES 
PROCEDURES RUN AS BATCH JOBS*®. The default for this 
procedure is to run in batchn modes but it can be run in 
focal mode. The dayfite parameter is used by this 
procedure. 
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print §: 


(optional) controis the action of the PRINT procedures 
used to print the output of FORMAT. If you run FORMAT as 
a batch job (the default case) and you don't code the 
print parameters FORMAT prints one (1) copy of the 
document on the ASCII printer. If you run FORMAT in tocal 
mode or “while you wait™s FORMAT does not print any copies 
of the document. For a complete description of the values 
that may be coded for the print parameter» see the 
description of procedure PRINT. 


Ss or source 3: 


this foptional) key specifies that the SOURCE of the 
document is to be printed in addition to the formatted 
output. If you don'tt code the s keys the source isn*t 
printed. 


k or keepout : 


code or 


head or 


(optional) name of file in which to KEEP the OUTput of 
FORMAT. You can use this facility where you may want to 
run many copies of a document at a tater date. If there's 
no file of name specified by the k parameter in your 
catalogs FORMAT ptaces the output in a DIRECT access file 
of the specified name. If such a file already existss 
FORMAT overwrites it with the output of the run. 


Note : that if you code the k parameters FORMAT produces a 
display file (see above) and saves thats rather than saving 
the full size listing file which is usuaity targe. 


form or txtcode or txtform ; 

these (optional) keys determine which formatter is to be 
used by FORMAT to process the document source. If you 
don*t code any of these keys» FORMAT runs the TXTCODE 
processs which is the same as tf you coded the code or 
txtcode keys. If you code the form or txtform keys FORMAT 
runs the TXTFORM process. Note: you can change the 
default setection by defining in your profile a variable 
called FORMAT and setting its vatue to "TXTFORM*® or 
‘FORM, 


txthead : 
this (optional) key invokes TXTHEAD>» a special 
postprocessor for the document formatting system. TXTHEAD 
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is used to change the headings that appear at the top. of 
the document pages» where the standard headings are 
inappropriate. Documentation for TXTHEAD can be found in 
an appendix to this User Handbook. If you code the head 
keys FORMAT runs TXTHEAD. 


twopage : 

this (optional) parameters if codeds directs FORMAT to run 
the TWOPAGE procedure (described in this chapter) which 
places two pages on one printer page. Since the maximum 
width of ao printer page is 136 columnss if you happen to 
have wide platen documentss the output tends to fook rather 
stranges so for effective use of twopages your documents 
should be fess than 68 columns wide. twopage may be coded 
just asa keys or it may have a tist of valuess namely the 
pw parameter and the seq keys as in the description of the 
TWOPAGE procedure tater in this chapter. 


Neate : that the twopage option only affects the printed 
copy of the output. The actual data in the files specified 
by the d or ?! parameters is not affected. 


esg or nomsg °: 
these (optional) keys control the generation of 
informative messages by this procedure and are “fully 
described in section 1.8 ~ “INFORMATIVE MESSAGES FROM SES 
PROCEDURES”, 
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Examples of FORMAT Usage 


seseformat myfile 
17042.55. SUBMIT COMPLETE. JOBNAME IS ADCQBUG 
* J0B FORMAT SUBMITTED 


This is the very simplest example of using FORMAT. myfile 
contains document source written in TXTCODE form. The document is 
processed by FORMAT», and one (1) copy is printed on the ASCII 
printer. FORMAT runs as a batch jobs freeing up your terminal for 
further processing. 


seseformat newfiles oldfiles print=(cz2shz2no)s ss jobti=4000(8) 
13232255. SUBMIT COMPLETE. JOBNAME IS ADUQBOG 
* JG8 FORMAT SUBMITTED 


This example is more complex. The files newfile and otdfite 
contain respectively the latest and previous versions of a 
document. Both versions are coded in TXTCODE form. FORMAT 
processes both tots of sources uses the revision bar generator to 
generate change bars on the final document. The source of newfile 
is printed because the § key is coded on the call fine. It's 
assumed that the documents are large and require tots of computer 
time to process thems so jobti=4000(8) is coded to give FORMAT twice 
the normal time. Finallys the print parameter specifies that two 
(2) copies are to be printed with no heading banners. 


seseformat iznewfiles bzotdfiles txtforms print=c=4 
11.35-243- SUBMIT COMPLETE. JOBNAME IS AODRICAD 
* J08 FORMAT SUBMITTED 


This example shows FORMAT used to format the document newfiles 
with oldfile as the base version for generating revision bars. The 
txtform key indicates that the source of the two documents is in 
TXTFORM formats and so the TXTCODE stage of FORMAT is bypassed. 
Finatlys Four (4) copies of the output are printeds because of the 
printzc=4 parameter. This tast parameter indicates how the print 
parameter is coded when it has only one subparameter in its tists as 
opposed to the exampie aboves where the print parameter has two 
subparameters in its fists so that they must be enclosed in 
parenthesese 
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seseformat i=grabage local print d=tooksee 
RUNNING TXTCODE ON GRABAGE 

RUNNING TXTFORM 

FORMATTED DOCUMENT ON FILE LISTING 
PRINTING LISTING 

CREATING DISPLAYABLE DOCUMENT LOOKSEE 
END FORMAT GRABAGE -> LISTING LOGKSEE 


Hee eH 


This exampie shows how to use FORMAT at the terminais or “while 
you wait”. The file grabage is assumed to contain the source of a 
document in TXTCODE form. FORMAT runs while you wait because the 
focal key is coded. FORMAT olaces the formatted document on a file 
called fisting and prints one (1) copy of it on the ASCII printer 
(because the print key was specified). The file called tooksee 
contains a copy of the formatted document suitable for displaying at 
a teminal. The example shows the informative messages output by 
FORMAT to reassure you that there's something going on. 


seseformat draft batch twopagezseq 
12-10.30. SUBMIT COMPLETE. JQOBNAME IS AMTBSOB 
* J0B FORMAT SUBMITTED 


This exampfe shows the twopage option used to double up on the 
printed output and save a few trees. 
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Data_Elow of .EQRMAT. Procedures 


seseformat ixzanyfile 


2 
a 
Gram wwanh} 


ee es a 
/ : 73 
$oeen—-- = ——+ 
; TXTCODE H 
: DOCUMENT 3. 
5 
a 
+ 


a 
a 
® 
+ 


FORMATTER i/ 


a Sr 
/ H 43 
ne a 
3 TXTFORM 2? 
: DOCUMENT ? + 
3 FORMATTER i7/ 


The diagram shows two of the ways that FORMAT can runs 
The teft hand diagram shows the normal and 
The right hand diagram shows 


on the options you code. 


simplest case of 


TXTCODE is a 
<= PREprocessor 
for TXTFGRM 


----------> TO 


+ 
: 
PRINTER <---------! 
: 
+ 


FORMAT. 


Coding the 
causes the 
the input 
processed 
TXTFORM. 


oe 2S 2H OO 4H O26 2H OH OF OO OH 
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seseformat izanyfiles txtform 


txtform key 
contents of 
file to be 
directiy by 


ai 


aicceseees +3 
TXTFORN : 3 


FORMATTER $ 


+ 
6 
3 
+ DOCUMENT $ + 
+ 


SD EE AD ND AER SD SO A A CED 


that 


the txtform or form key eliminates the TXTCODE process. 
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seseformat iznewufiles beoldfile 


this processes “newfile® this does "“oldfile™ 
e 9 
e i] 
Hemme to--—-= + trem em tent 
/ ; ‘3 / : : 
temeceroweens fj teoereecoewmn > . § 
: TXTCODE ¢ 3 + TXTCODE i: 3 
s DOCUMENT : + + DOCUMENT 3§ + 
s FORMATTER 3/ ¢ FORMATTER i/ 
tome m en tem——+t toreer mn tent 
: tS Sesser e ; 
‘ / ; ; 
: a a. ; 
Poem oeeen=s==)5, GENERATE 16 ¢3=so3==seees= + 
> REVISION ¢ + 
- BARS : 
teem nn tent 
: 
tern tenn--——+ 
/ - ; 
teen nnn nent { 
TXTFORN ; 
DOCUMENT ; + 


: H 
: : 
? FORMATTER 3/ 
+ + 


oe an cw ewan > ee coe 


+ 
7 
PRINT H 
H 
+ 


This diagram shows the action taken when you run FORMAT with a 
current decument and a “base™ version of the document. The revision 
bar generator compares the two files after TXTCODE has processed 
thems and generates the commands such that TXTFORM knows where to 
piace revision bars in the final document. 
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seseformat myfile source 


om ae 


s | a 
3. a 


oe a es 
/ H 43 / $ 43 
$—<----- == + 3 ne a. 
: TXTCODE : 3 $3 
: DOCUMENT : + PRINT ; + 
t 
a 


FORMATTER $ 


a a 
a id 
. 


46 we oa 
ae 


+ ® 
$ TO 
oe : Pp R I N T E R 
3 TXTFORM ¢ 3 

: DOCUMENT : + 

3 FORMATTER ¢7/ 

Pwowwoewan Ff woewwa } 


s 
a 

-}---------- > TO PRINTER 
+ 


- 08 we 26 


This diagram shows what happens when you run FORMAT and code the 
source key. The source of the document is printed directiys then 
the formatting process takes ptace to produce a formatted document. 
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322 EQRMREV_=-_FORMAT_ A_REVISION_ PACKAGE _EROM DOCUMENT SOURCE 


FORMREV is intended to format documents and run the GENREVP 
package described taters to produce a revwision package for a 
document. FORMREV uses the FORMAT and GENREVP procedures in a 
manner suitabte for most of the standard day to day document 
applications. If you have any complicated situations you should use 
FORMAT and GENREVP “manually”™ to cater for the situation you want. 
Parameters to FORMREV are 3: 


ior f or new : 
name of NEW Input File containing the new document source 
to be processed by FORMREV. 


b or otd ? 
(optional) name of file containing OLD document source to 
be processed by FORMREV. If you don't code this b 
parameters, you should suepny the file specified by the 
parameter. 


r or rlist 3: : 
(optional) name of file containing the output of a 
previous FORMAT rune If you don't code the fr parameters 
you should supply the File specified by the b parameter. 
Of courses both b and er may be coded, 


ft or tisting : 
(optional) name of file to receive the tisting of the 
selected pages after the comparison. If you don't code 
the { parameters, FORMREV uses file tisting. 


Ss or summary 3 
(optional) name of file to receive the summary of the 
changess and a “how to update the document™ description. 
If you don*t code the $ parameters FORMREV uses file 
suamary. 


o or output : 
(optional) name of file to receive the GUTPUT of FORMREV. 
The output file contains error messages and statistics. 
If you don't code the o parameters FORMREV attempts to use 
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PROFILE variabie outputs and if such a variable doesntt 
exists fite output is used. 


batch job parameters : 


print : 


These parameters are described in section 1.7 - "SES 
PROCEDURES RUN AS BATCH J0BS*",. The default for this 
procedure is to run in batchn modes but it can be run in 
focal mode. The dayfile parameter is used by this 
procedure. 


(optional) parameter fist (las for the PRINT procedure) 
which controls the PRINTing of the I» s and o files. If 
you run this procedure in tocal modes no printing is 
performed. If you run this as a batch jobs the default 
action is to print one (1) copy of those files. 


format or formatli :; 


format2 


genrevp 


foptional) tist of parameters to controi the FORMAT run 
that produces the new version of the text. The parameters 
are as for the FORMAT procedure described previously. 


2 
(optional) tist of parameters that controfi the FORMAT run 
that produces the old version of the texts in the case 
that the r parameter wasn't coded. The parameters are as 
for the FORMAT procedure described previously. 


(optional) tist of parameters that control the actions of 
the GENREVP procedure described bellows when GENREVP is 
called into play during the run of FORMREV to produce the 
final output listings. The parameters are as for GENREVP 
described below. 


msg or nomsg : 


these foptional) Keys contro} the generation of 
informative messages by this procedure and are fully 
described in section 1.8 -— "INFORMATIVE MESSAGES FROM SES 
PROCEDURES*®,. 
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Examples of FORMREV Usage 


seseformrev iznewudocs bzo0lddoc 
09045234. SUBMIT COMPLETE. JOBNAME IS AEXICOG 
* _ JOB FORMREVY SUBMITTED 


This exampie shows FORMREV used to generate a revision package by 
comparing newdoc (the current version) with ofddoc (the previous 
version). FORMREV produces aie printout consisting of those pages 
which differ between the two documentss and a summary indicating 
which pages are changed. The changed pages have revision bars 
against those lines that differ. 


seseformrev nendocs rzoldtists format=txtforms jobti=5000(8) 
146452564. SUBMIT COMPLETE.}j JOBNAME IS JACIBHI 
¥ JGB FORMREV SUBMITTED 


This exampie generates a revision package by comparing the 
results of formatting the current document newdoc with the old 
listing file oldtist. The formatting process is to be done with the 
TXTFORM formatters bypassing the TXTCODE processs as indicated by 
the formatetxtform parameter, The job time timit Is set to 5000 
seconds (octal) by the jobtiz5000(8) parameter. 


seseformrev izcurrents bedateds genrevp=(howzcomfiles folio) 
16.32-4¢8. SUBMIT COMPLETE. JOBNAME IS AFTXBUD 
* J08 FORMREV SUBMITTED 


This example shows FORMREV used to generate a change package for 
the documents current and dated. The portions of the tisting pages 
that are to be ignored are not the standard ones normaily used by 
the GENREVP procedures so the genrevp parameter is coded to indicate 
that the directives are on file comfiles and that the folio tine 
{indicated by the folio key) is also to be ignored for the purpose 
of comparison. 
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Dataflow of EQRMREVY Procedures 


ses.formreyv iznenfiles bzotdfile 
a i 
Py r | 


$n ne nee een nen ee ee enn H 

; ee oe 

H H H 

a a oe 2 rt oes 

/ H 43 | ; 43 / H 43 
free nec eee ne + $ Sennen enne ro] beseaeesslans 3 
3 TXTCODE : TXTCODE 3 3 TXTCODE ¢$ 3 
3 DGCUMENT ¢ + DOCUMENT ? + 
s 
a 


FORMATTER 3 


+ 

+ DOCUMENT 3? + 
: FORMATTER 37 
+ 


+ se 40 oo 


; 

; 
FORMATTER 3/7 

+ 


ee a fs tomm—+ en cones o 
H H H 
H a + ¢ 
H / H fi ; 
; to----------+ } : 
3 3 GENERATE ¢ 3} H 
tenwen—------>! REVISION ¢$ + : 
3 BARS 3/7 H 
es ee Y H 
H H 

Se eee S a 


/ H H / H H 
tome nnn +3 ee 
The diagram shows how $ TXTFORM $ $ $$ TXTFORM ¢ & 
FORMREV processes ai ODOCUMENT $ + $ DOCUMENT $ + 
current version of a i FORMATTER i/ : FORMATTER 3 
+ 


documents and an old t------ $se=% t=S-+=> tos==¢ 
version of the same H H 
documents to generate teen tem + H 
a change package with / H H H 
revision bars on the t---ceor-—--4t § H 
changed pagese GENERATE 3 <t--e ener + 


a 

+ REVISION ¢$ + 
s PACKAGE i/ 
+ 


oe ae ee oe a ee owes} 
H 
a + 
/ H 43 
$o----------+ 3 
~{ ---------- > TO PRINTER 
+ 
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ses.formrev iznewfites bzoldfiles r=oidtist 
J s @ 


; 
S Staaten Seether 2 Fomor n toon m—n—t ; 
/ 3 43 / ; 4s ; 
epee a ae ae en ae ao em aw + 3 Foe memwommt § H 
s $FXTCODE $ ; + <TXTCODE 3: § ; 
: DOCUMENT 3 + s DOCUMENT ¢ + : 
? FORMATTER 3/ $ FORMATTER i7 H 
From r enn tenr——t. terme — $um——+ ; 
H 3 3 
tome tome w wnt H : 
/ $ ; . : 
tonne nn------+ : : 
t ‘SENERATE 2 <t—~<=-=—<---=-- + ; 
+ REVISION ¢ + ; 
H BARS s/f : 
$e ew enter t H 
; : 
S Destenatnads Saute f 5 heheh Peete eatet 2 
/ ; ; / ; ‘i 
treme nnn nm t 3 tommorow een —t j 
$ TXTFORM 8b emer nme nnnnmn-->) GENERATE ¢ 3 
: DOCUMENT ? + : REVISION ¢? + 
$ FORMATTER $7 3 PACKAGE i 
tem atuahemeatentesh 4 teen tenet 
: 
treme term t 
4 : 4s 
teem newer n— mt f 
TO ; 7 3 
(neem nnn nnn men---t PRINT) $+ 
PRINTER H of 
$or wenn ne + 


This diagram shows FORMREV used to generate a revision package 
where ali three forms of the document are used : the current 
version of the documents newfiles the old version of the document 
sources oldfiles and the old document tistings ofdtist. In this 
case» FORMREV uses the old tisting as the base against which to 
compare the processed version of the new document. Because the old 
document source was used as wells the change pages produced by 
FORMREV have revision bars on them. 
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seseformreyv isnewfiles rzoidiist 


ot eS 
/ : H 
ee oe $ 
+ TXTCQDE ¢ 3 
+ DOCUMENT ¢$ + 
+ FORMATTER $7 
+ 


GF OS 40 66 08 26 Oe Oe 0% HO wh C8 06 


‘ pa Scat oe eat 
$rewe meme mnt . j 
3 TXTFGRM ¢ § 
+ DOCUMENT ¢ + 
? FORMATTER 7/ 


ee +> oe 24 2H 26 ee 46 


: 
H $oree—f— se ew ame om me 
H / 43 
H Be ee ae ae ee ee coe oe eam ey 8 
teem meen === >: GENERATE 3 $ 
$ REVISION $ + 
: PACKAGE H 
a ey 
H 
a ee + 
/ H 43 
he ee ree ae oe ae ee oe + § 
; $e § ero oe n--—----> TO PRINTER 
H PRINT 3 + 
H 3/ 
eS 


This diagram shows the simplest use of FORMREV. The current 
version of the document is compared with the ofd tisting of the 
document in order to generate a change package. In this case there 
are no revision bars generated on the final output since there was 
no old document source given to FORMREV to be processed. 
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303 SPELL_=_CHECK FILE_FOR_ SPELLING MISTAKES 


SPELL checks for words in a document that are spetted 
incorrectiy. Parameters to SPELL are 3 


ior f : 
name of Input File to be checked for spelling mistakes. 


0 3 
(optional) name of the file to receive the Qutoeut from 
SPELL. If you don't code the o parameters SPELL uses file 
OUTPUT. 

dict or d 3 


loptional) name of a file containing words (one per fines 
left justifieds alf tetters in tower case) that are to be 
used in conjunction with standard "dictionary" used by 
SPELL. If you dontt code this parameters SPELL uses onty 
the standard dictionary {containing approximately 50000 
words) when checking for misspeifed words. 


dictun or dun : 
(optional) Username in whose catalog the additional 
dictionary specified by dict is found. The default is the 
current user's catalog. 


(optional) List options availabie for output format. 

briefs the defaults displays three columns containing each 
“nispelled™ words the input File line number at which the 
word was first encountereds and the number of subsequent 
references of that word in the text. 

full is a proof reader's format. The entire text tine 
containing the "misspeftied"™ word is printed out and the 
word In question is "filagged™ on every occurrence. 
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Examples of SPELL Usage 


sesespeli newdoc 
* END SPELL NEWDOC 


This example shows the simplest use of SPELL. A tlist of the 
words in file NEWDOC that are suspected to be misspeited along with 
a count of the number of times each occurs is written to file 
OUTPUT. Oniy the standard dictionary was used since the dict 
parameter was omitted. 


sesespeti izsomedocs dictz=jargons ozbaddies 
* END SPELL SOQMEDOC 
This exampie shows SPELL appiied to a file catted SOQMEDODC with 


additional words from dictionary file JARGON. The output of SPELL 
appears on file BADDIES. 
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304 TWOPAGE = PRINT TWO DOCUMENT PAGES SIDE_BY_SIDE 


TWOPAGE takes the output of any of the text processors and places 
two outout pages on one printer page. This reduces both paper usage 
and print times which is invaftuable while documents are in their 
develooment stages and being turned around fast. 


The input for TWOPAGE must be in 8 of 12 ASCII format and not in 
NOS 6/12 ASCII. Its output is also in 8 of 12 ASCII. Parameters to 
TWOPAGE are ? 


ior f 3 
name of Input Eile to be processed by TWOPAGE. 


{optionat) name of Qutput file from TWOPAGE. If you don't 
code the o parameters, the output appears on a file of the 
Same name as the input file specified by the 4 parameter. 


pwoor width : 
(optional) Page Width of the output pages. If you donft 
code the pw parameters, TWOPAGE uses a default page width of 
137 (136 columns plus one column of carriage control). 
Remember to cater for the carriage control column when 
specifying the page width. 


seq : 
this (optional) key indicates that SEQuence numbers are to 
be placed on the finat’ printout. The sequence numbers 
appear down the center of the printer page between the two 
document pages. Default action in the absence of the seq 
key is no sequence numberse 
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Exampftes of TWOPAGE Usage 


sesetwopage i=ztextouts o=listings seq 
* END TWOPAGE TEXTOUT -> LISTING 


sesetwopage Fformatd 
*. END TWOPAGE FOGRMATD 
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305 DIAGRAM _=_DLAGRAM. DRAWING AID 


DIAGRAM is a documentation aid for drawing diagrams. The "data 
fiow diagrams” in this section of the SES User's Handbook were drawn 
using OILAGRAM, Basicailys a page is considered as a three columns 
five row grids into which you can place various shapes. You stiidl 
have to do some manual editing to join tines and add texts but the 
bulk of the pain of drawing the shapes is done for youe Shapes 
available via DIAGRAM are those shown belows with their "names" 
given for reference, 


: "BOX* : "COND" 
: 4 N 
$o----—- $——----- + +—-----/ \w---<+ 
2 MMXMKKKKKKKKK § S MKMKKKKKKKKKK 8 
“BLANK® 5 MM KKKKKKK § 3 MKMKKMKXKKKKKK 3 
3 MMMM KKKKKKK § 2 MRK KKKKKKKKK F 
$m ew ewe $ ee eww + fomememen) 2 femme t 
H \ 7 
; H 
; “CONN™ WIN $ "LINE® 
: 3 
i : 
/ \ \ / H 
i». \ / H 
\ / \ 74 H 
se : ; 
: : ‘ 
H H H 
; "OuUT® : *STACK* $ "TABLE 
H eS oe | ooo 
H H H TABLE H 
4 N tot mmm mn nnn te {-----— woe ocr nnn j 
/ \ H {-+ 2 MMKKKKKKKKKKK § 
/ \ oe 2 MMM KXKKKKKKK § 
2 MKKXEKKKX f+ 3 KMMKKKKKKKKKK § 
S eeeteteeete ete 5 $—- See + 
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: “CUBE™ 
ooo 

/ ; H 
ot a 
5 MKMKKKKKK Ff 
5 MMKRXMKKX 2 + 
2 MKKKKKKXK 3 7/ 
+ 


a 
8 


To use DIAGRAM you catlt up the SES DIAGRAM procedure with the 
following parameters 3 


name of the file to receive the Qutput from DIAGRAM. This 
parameter is required. 


The next three parameters are introduced by the keywords cl and 
e2 and c3.2 They represent a iist of shapes that are to be placed in 
cofumn ones column two and column three of the page grids 
respectively. For examptes the grid of shapes given above was 
generated by the fotltiowing SES call : . 


sesediagram ozanyfites cl=(blanksconnsoutscube)s eecee 
c2=(boxsinsstack)s c3=(condstlinestabtie) 


where anyfile is the output file used for the exampite. The shape 
"names" were added by editing the output file. It is usual to 
include diagrams in your file in "asis™ mode. 
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306 MEMO_= GENERATE STANDARD MEMO_HEADER 


MEMO places ai standard TXTCODE format banner at the front of a 
file containing the text of a memo.» Dates tots 'from* and subject 
information can be entered as parameters to MEMO. Internal to the 
resultant files the TXTCODE table directives are set up such that 
further recipients! names may be added easily. Parameters to MEMO 
are as follows : 


for f : 
name of Input Eile containing the text of your memos to 
which the standard header is to be added. 


0 3 
(optional) name of the file to receive the Qutput of MEMO. 
If you don't code the o parameters MEMD places the output 
on the file specified by the i parameter. 

to : 
{optional) name and location of the person to whom the memo 
is to gow It is coded as a tist3 the first item in the 
fist is the recipient's name and the second item is the 
location. 

from : 
{optional) name and tocation of the person sending the 
MEMOs It is coded similar to the to parameter. 

when : 


{optional) date to be placed on the memo. If you dontt 
code the when parameter, MEMO uses today's date as a 
default. 


s or subject : 
(optional) string which is the subject tine to be ptaced in 
the memo. 


Some of the parameters above can get default information from 
your profiles as follows : 
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320 DOCUMENT FORMATTING SYSTEM 
3e6 MEMO ~ GENERATE STANDARD MEMO HEADER 


faccode 


myname 


is the EACiflity CODE variable. The value of faccode are 
used both for the to and from focation if they aren't 
specified as parameters. 


is the profile variable containing your names which is also 
used by the mail facilities. If you don't code the first 
element of the from parameter lists MEMO uses the myname 
profile variable. 


By this time you shoutd be suitably confused by this explanation 
so an exampie is in order 3 


sesememo 


izanyfiles toz=('Ethel Snerge's london)s cece 


from=(*Stanistaus Bonokowonokowitch's parislsescse 
subject=*hunting the snark! 
* END MEMO ANYFILE 


The result of this would be a standard memo header at the start 
of anyfile as shown on the next page ; 
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\para 
\setu” 
\seth* 
\setba 
\blank010 
\skip4 
Nasis 
\bold 
4 M EEEEEEE MM MM 
c M M CE MMMM OQ 0. 
D M M OM EEEEE 4M M M OQ 0 
C M M 4 0 0 
M M M 


aaa 


E M 
EEEEEEE M 
\noboid 
A\tabie 31245 
\skips¢ 
3**“DATE*2*MAR 145 1979 
\skipl 
A\table31s45 
3**"**TO*s“ETHEL SNERGESLOCATION”: “LONDON 
\table311s56 
\skipl 
\table31545 
3*“*FROM*:“STANISLAUS BONOKOWONOKOWITCH3LOCATION*:*PARIS 
\table311556 
\skip2 
\tabie51545 
SSUBJECT*:“*° HUNTING THE SNARK” 
\block 
\skip4 


COMPANY PRIVATE 


3-26 
CDC - SOFTWARE ENGINEERING SERVICES 


7/30/81 
SES (Release 34 User's Handbook REV: AB 


320 DOCUMENT FORMATTING SYSTEM 
327 TXTCODE - RUN TXTCODE DOCUMENT PREPROCESSOR 


307 IXTCODE -_RUN_IXTCODE DOCUMENT PREPROCESSOR 


TXTCODE is a high level preprocessor for TXTFORM. This procedure 
runs TXTCODE in a stand alone fashion.» It may be used as a building 
block for larger procedures to form a complete document formatting 
system. Parameters to TXTCODE are 3 


ior f 3 
name of Input File containing source text to be orocessed 
by TXTCODE. 


0 3 
Coptional) name of file to receive the Qutput from 
TXTCODE. If you don't code the o parameters the output 
appears on the file specified by the i parameter. 

e : 


{optional) name of file to receive the Error output from 
TIXTCODE. If you dontt code the e parameters, TXTCODE 
doesn't produce any error File. 


Example of TXTCODE Usage 


sesetxtcode codein codeout errtlist 
* END TXTCGDE CODEIN > CODEOUTs ERRLIST 


This exampte shows TXTCODE used to process the data contained in 


file codeins and produce the TXTFORM source on file codeout. Any 
errors go to file errlist. 
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3e8 IXTEQRM_=_RUN_TXTEORM DOCUMENT PROCESSOR 


TXTFORM is the main component of the document processing system. 
This procedure runs TXTFORM stand alone. It can be used as a 
buitding bitock for targer procedures to form a complete document 
formatting system. Parameters to TXTFORM are ; 


ior f 3 
name of Input File containing source text to be processed 
by TXTFORM. 


{optional) name of file to receive the OQutput from 
TXTFORM,. If you doen't code the o parameters the output 
appears on the file specified by the i parameter, 


Example of TXTFORM Usage 


sesetxtform izforminps ozformout 
* END TXTFORM FORMINP =-> FORMOUT 
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309 IXTHEAD =_ PAGE HEADING PROCESSOR 


TXTHEAD is a postprocessor for TXTFORM. TXTHEAD is used to 
change the format of the heading banners on document pagess where 
the standard heading format is inappropriate, There is 
documentation on TXTHEAD in and appendix to this User Handbook. 


This TXTHEAD procedure runs TXTHEAD in a stand alone fashion. It 
may be used as a bullding block for larger procedures or jobs to 
form a complete document formatting system. Parameters to TXTHEAD 
are 3 


ior f : 
name of Input File containing TXTFGRM output which is to 
be processed by TXTHEAD. 


foptional) name of file to receive the Qutput from 
TXTHEAD. If you don't code the o parameters the output 
appears on the file specified by the i parameter. 


Example of TXTHEAD Usage 


sesetxthead izformouts ozheadout 
* END TXTHEAD FORMOUT => HEADOUT 


This example shows TXTHEAD being used to process the output of 


TXTFORM contained on the file formouts and produce the output fite 
headout. 
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3010 GENREVB_=_GENERATE_REVISION BARS FOR DOCUMENTS 


GENREVB is a procedure that works in conjunction with TXTFORM,s to 


format a 
Show cha 


document with bars down the right hand side of the page to 
nges from a previous document. GENREVB functions by 


comparing the source text of two documents and generating a set of 
special directives to TXTFORM. Parameters to GENREVB are 3; 


ior f 


b or of 


neweset 


ofdcset 


outcset 


ts or i 


or new 3: 
name of File containing the NEW version of the document in 
TXTFORM source format. 


d 3 
name of fite containing the OLD (or Base) version of the 
document in TXTFORM source format. 


(optional) name of file to receive the Qutput from 
GENREVB. If you dontt code the o parameters the output 
appears on the file specified by the i parameter. 


(optional) designator for the NEW file's Character SET.e 
The table below describes the allowed designators. 


2 
s 


(optional) desiqnator for the OLD file's Character SET. 
The table below describes the allowed designators. 


2 
s 


(optional) designator for the QUTput file's Character 
SET» The table below describes the altowed designators. 


gnoris : 

these foptional) keys specify whether or not to JGNORe 
Leading Spaces on tines being compared. The default action 
is to recognise teading spaces (the ts option). If you 
code the ignorts key» GENREVB ignores leading spaces on 
text lines. 
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The default character set desiaqnator for ail three eset 


parameters is ¢s612-+ The following table defines the allowed 
designators for the cset parameters ;: 


een et nee a ee ae a A NS SA NO A A A A RN Ha sO te + 
a 2 2 
a F | : 
; Designatoc : Meaning H 
a 3 3 
8 a 3 
ee ee ce ee ee ee ee ee ee wee comm ae come cme 
; ; ; 
; cs612 $ NOS 6/12 ASCII character set ; 
8 3 : 
% FY 3 
+ 0 A ER ND le A A A a ee te ae + OA GD A ANTS A AN IE AE NS AO SAE SE Sn ERA Aa “ERG SS SE ENN “AN “AOE <A SN OES A SN ONE OREN SN A EO =O ON OC I + 
; H 3 
H cs64. 3 64 character ASCII subset {display code) 
; 3; character set H 
: | 3 3% 
3 3 3 
oe we 0 ee ee oe ee OS EN SNE AR ae air ee oe oe ee ee 00 ee ne a ee a a MG RS CE TT EER A A GR OR + 
H H ; 
; cs812 :; "8 aout of 12” ASCII character set H 
2 a § 
2 3 3 
+ + + 


Example of GENREVB Usage 


sesegenrevb fiznewtexts bzoldtexts ozchanges 
* END GENREVB NEWTEXT =: OLDTEXT -> CHANGES 


This exampte shows GENREVB used to compare the two document 


source files newtext and oldtext»s and produce the change directives 
in the text on file changes 
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3011 GENREVP_=_GENERATE_A_REVISION PACKAGE FOR A DOCUMENT 


GENREVP bultds a revision package by comparing the output of two 
formatted documents. Parameters to GENREVP are 3 


new or newdoc : 
name of NEW DOCument to be processed by GENREVP. 


old or ofddoc : 
name of OLD DOCument to be processed by GENREVP, 


how or howfile : 

is toptional) and specifies HOW the processing is to be 
performeds that iss which fines are to be ignored for the 
purposes of the comparison (dates time and such). The how 
parameter is either the name of a file containing the 
directivess gor it's a list of character strings on the 
contro! card which specify the directives. If you dontt 
code the how parameters GENREVP attempts to use the file 
name associated with PROFILE variabie myhowf. If there 
isntt such a variable in your profiles GENREVP uses a 
standard set of directives suitable for the standard 
outout of FORMAT. 


! or tisting :; 
{optional) name of file to receive the tisting of the 
selected pages after the comparison. If you don't code 
the ! parameters GENREVP uses file listing. 


Ss or summary 2 
(optional) name of file to receive the summary of the 
changes» and a "how to update the document" description. 
If you don't code the $ parameters GENREVP uses file 
summary. 


o or output °: 
(optional) name of file to receive the OUTPUT of GENREVP. 
The output file contains error messages and statistics. 
If you don't code the o parameters, GENREVP attempts to use 
PROFILE variable outputs and if such a variable doesntt 
exists file output is used. 


folio : 
this (optional) key indicates that the FOLIO line of the 
documents is not to be compared for the purposes of 
generating the revision package. 
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GENREYVP_ Directives 


Directives to GENREVP (specified via the how parameter) are of 
the following form (one per tine) : 


Lleel2 C1..C2 - comments 


L1..l2 specifies a range of tines (if you only want to indicate a 
Singte fines the .2L2 can be omitted; and if you want to indicate 
all finess use an ¥*)3 and C1..C2 specifies a range of columns Cif 
you onty want to indicate a single columns the ..C2 can be omitted; 
and if you want to indicate all colflumnss use an *). Any comments 
present on a directive tine are ignored. The directives are used to 
tei! GENREVP what parts of what tines are to be ignored when 
comparing pages of formatted documents for differences. The 
standard set of directives is : 


2 602-79 page number 

3e 2% 602279 date 

x 8022136 formatting codes ( junk) 
60 *. Folio line 


The tast directive is generated onty if the folio parameter is 
given. 


Exampies of GENREVP Usage 


sesegenrevp thisdocs thatdocs fotio 
* END GENREVP THISDOCsTHATDOC -—> LISTINGs SUMMARY 


This example of GENREVP compares the two document tistings 
thisdoc and thatdoc to generate a listing of the changed pages. on 
the file tistings and a summary of the changes on the file summary. 
The folio key indicates that the fotio fine is also to be ignored. 
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sesegenrevp grabs hotds how2('3.24 602279%, ** 80..999') folio 
* END GENREVP GRABsHOLD --> LISTINGs SUMMARY 


This example shows the how parameter of GENREVP used to indicate 
that character positions 60 through 79 on tines 3 through 4 are to 
be ignored for the purovoses of comparisons and that character 
positions 80 through 999 on all (#) tines are to be ignored. In 
additions the folio key indicates that the folio fine is also to be 
iqnored. 
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400 SOURCE TEXT MAINTENANCE 


SES provides a comprehensive set of procedures to manage source 
text libraries. The source text maintenance package of SES is based 
on a special version of the NOS utittity MODIFY calted MADIFY. 
MADIFY differs from the standard version in that It caters for the 
NOS 6/12 character set; and it supports nested and conditional calls 
to common decks {see the description of the GENCOMP procedure for 
details on the CALL directives avaitable to the MADIFY user). 


It's assumed that if you're using these source text maintenance 
proceduress that you're moderately famitiar with the concepts of 
MODIFYs including things such as decks» common decks» correction 
idents and so one If you're nots SES can't provide a substitute for 
knowing what you're doing. Before giving a short summary of the 
source text maintenance proceduress we'll introduce some of the 
terminotogy that SES uses. 


BASE is a library of source text. Alt(' the source text 
maintenance procedures use a default name of BASE. You can 
estabtish a default base in your profile by coding 


\ base = *whatever_your_base_is* 


MODULE is a record of source text on a basee A module may be a 
COMMON modute (COM or C or OPLC)» or a module may be a 
REGULAR module (REG or R or OPL) 


GROUP is a file containing text in the form of MODIFY “source"™ 
records. J[hat is2 each logical cecordg in the file has its 
name as the first line of the cecords and if the cecord is 
aaeanas deck2 the second line of the cecord is the word 


COMPANY PRIVATE 


4-2 
CDC — SOFTWARE ENGINEERING SERVICES 
7/30/81 
SES (Release 17) Users Handbook REV: AB 


PO REE PO REID PE OO PO AD PE PO FEO PE PO DE PE PE BO 28 28 28 P88 PE AE FO PE PA PE OE FE OE 28 08 OE OE PA FE PO OE HE TE BE PO OD FO PE TE PERE PD ETE OE FE PE PO 28 08 8 OE 8 EO 


4.0 SOURCE TEXT MAINTENANCE 


Summarcy_Of Source Text Maintenance Procedures 


GETMOD(S) 


REPMOD(S) 


COLLECT 


GENCOMP 


GENCOR(S) 


TEMPCOR 


MODIFY 


CATBASE 


LISTMOOD 


SORTMOD 


GET MODuleS gut of a base library onto a group file. The 
modufes appear on the group file in MODIFY “source® 
format as one module per togical record. 


REPtace or add MODuteS on a base ftibrary. You also use 
REPMOD(S) in a special way to create a brand new base 
library from scratch. 


colftect a group of modutes and accumulate them on a group 
file. 


GENerate a COMPile file for a module or a tJlist of 
modules. 


GENerate a CORrection Set for a module. 


Make TEMPorary CORrections to a base without actually 
creating a new base.» 


MOOIFY a base Jibrary with a correction set File creating 
anew base library. 


CATatogs a BASE tibrary to produce a short fist of the 
names and types of modules contained in a base library. 


LIST MODutles. LISTMOD generates a cross reference 
fisting of alt the modules on a base (using the XREFMOD 
procedure described below)» and optionally a source 
listing of all the modules or all the common modules = on 
the base. 


SORT a MODify tibrary. Modules appear on the sorted base 
in alphabetical order by deck name (the deck type is not 
used in the sort process). 
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WIPEMOD 


XREFMOD 


GETCOMN 


WIPE (delete) MODules from a base, 


Produces a cross X) REFerence of MODules in a source 
library. For each module is listed the modules it calls 
(directiy or indirectly) and the modules that call it 
(directly or indirectly). The LISTMOO proceduf ey» 
described aboves can be used to run XREFMOD as a batch 
Jobe 


ACQUIRES the CYBCCMN or CYBICMN common deck program 
librariess in either the MADIFY or SCU formss and makes 
them focal to your control point. 
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Dataflow of the source text maintenance arocedures 


BEVSSTECEsSsEsSeECsSEI=z / $ Pee SPS ET SE ESTE SF SE FE | 
REG t2sSee<—Ss== + 3 COM 
Creguiag =<+=<--<<= aaa 16d SSeS ese eee—= (common 
modutes) ; COLLECT $ + modules) 
BSSLSASASABSeLeSBE 4 :. SRLTETSALAVCABAse 


V 
SLePseeszzezezz2a2 RBRRATeLeszeszzeszezwez 
GRouP CORS 
teererrerrsernm----> 6 Caccumuliated {correction 
; modules) sets) 
: BSUBRESTSTALLARAzs REVRERATULASIaz2 
H 3 : 
; : ; 
; ; ; 
fewer tere + eee $e Ss—<F , deinen dated J 
i H 43 / V H / V 4s 
$ommm nnn mmm t j teem nr wn nent j Freee wm eowomn—4t 3} 
2 GETMOD(S) 3 3 3 REPMOD(S) ¢ ¢ : MODIFY 2 4 
+ (extract 3 + + (replace &: + t--->} (update 3 + 
$ modutes) i/ + modules) i/ : ; base) 3/ 
S eteaieteteeniiebeteteeh foe oe tment H force few} 
: ; : H 
H : ; ; 
; V : Vv 
: RRUTRSRRLete se ez : RLSBARETASSTTAIs 
; BASE H NEW BASE 
powwwaewoewewewewewmmmmwormwm 00 eee a 
PES SEES EE TE STE SE RSRERTARLSELAsSae 
; 
; 
: 
Pooweoe}oeworn} 

RBSRRRALTAAASSES tf y 43 SSBTSSTSTSESLEZ 
SF $----------- +! CF 
(source --------- “<--->! GENCOMP {%-$-----------> (compile 

modules) : ; + file) 
RBRRRARTAATIRSSEs $ $/ RSSSLARKTRLASSA 
toreeeroeoeer= + 
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4.0 SOURCE TEXT MAINTENANCE 


Parameter Naming Convention for Source Iext Maintenance 


This section 


introduces the parameter naming convention common to 


most of the procedures in the source text maintenance system. 


name of Base Library on which the operations are to 
be performed. 


c or com or optc tist of name(s) of COMmon modute(s). 


rf or reg or 


g or group 


cors or ¢ 


nb or ni 


op) 


list of name(s) of REGular module(s). 


stands for Module(s)s and is used in those 
applications where the module names do not have’ to 
be explicitiy specified as common or regular. 


name of File upon which a GROUP of modules are 
accumulated when adding or replacing modules on a 
bases or when modules are extracted from a base. A 
group File contains one module per logical records 
and may be edited using procedure MULTEDs and also 
may be processed by procedures PACK and UNPACK. 


name of CORection Setis) to be applied against a 
base for maintaining correction histories. 


name of a New Base or New Librarys», used in those 
procedures that perform operations that permanently 
aiter a bases requiring that a new base be 
created. An explanation of the method used to 
update a base is contained in a subsequent 
section. 
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PROFILE Variables _for_Source Text Maintenance 


The 


variables described betow may be dectared in your PROFILE in 


order to establish default information for the parameters of the 
source text maintenance procedures. 


base 


baseown 


newbase 


cors 


group 


cfseq 


cfwidth 


sestmpb 


lokmode 


name of base library where modules are to be found = or 
replaced. 


user name in whose catalog the base ts to be found, 


name of new base library for those procedures which update 
a base library» thereby creating a new one. The default 
name for newbase is the same name as the old base. 


used by allo procedures as name of File containing 
CORrection Sets to be applied to a base. The defauit name 
for this file is cors. 


used by all procedures to designate a group files or a file 
containing modules in source formats one module per togical 
record. The default name for group is group. 


used by GENCGMP to tndicate whether to place sequence 
numbers on the compite file. If you wish to use this» 
declare it as seq. 


used by GENCOMP to specify the width of the compile file. 
The default value for this is 110. 


used by all of the procedures that update bases to specify 
the temporary base file during the update process. The 
defauit name for this file is sestmpb. 


used by ali of the procedures that update basess to 
determine the default interlock action. tokmode may be set 
to one of "LOCK* or *NOLOCK®. See also the sections below 
on updating bases and interlocking. 
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intrlok used by att of the procedures that update bases or 
libraries to specify the intertock file to be used during 
the update process. The defautt name for this file is 
intriok. 
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Base VUedating Process 


Some of the source text maintenance procedures physicatiy after a 
bases requiring that a new base be created. The process is common 
to all such proceduress and is as follows 3 


If you code both the b and nb parameters» the new base is created 
simply by performing the required operations on the old bases and 
writing the newly created base onto the file specified by the nb 
parameter. 


If you code only the b parameters, the update takes place in two 
stages. The updating operation is performed and the new base 
written to a file called sestmpb (SES TeMPorary Base). sestmpb is 
then physicaity copied back over the file specified by the b 
parameters and finatty sestmpb is purged. 


Note that if the file soecified by the nb (or b if nb is omitted) 
does not already exists a DIRECT access READ mode file is DEFINEd 
for the base (this»s of courses can onty be done if the owner of the 
base is the current user). 


Note that if anything goes wrong during an updating runs the 
original base is always teft intacts and only the new base or 
sestmpb is potentially incorrect. This means that you can recover 
by purging the new base or sestmpb and starting the run agains If 
something goes wrong before the base appears on sestmpbs the 
original base is intacts and sestmpb may be purgeds whereas if 
something goes wrong aftec the new base is on sestmpbs that is» 
during the “rewrite” phase of the update, it is sestmpb that iis 
safes and the old base that is wronge In this cases you may use the 
REWRITE procedure to do the rewrite agains or alternatively» you may 
just purge the old bases then change the name of sestmpb to be the 
base name. 
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Interlock Process for Uedating a Base _ or Library 


When updating a base or tibrary you can intertock the update so 
that only one user at a time can update the base or Jibrary. Those 
procedures that update a base or library are set up so that if the 
base or Jibrary to be updated is in another user's catalogs the base 
or tlibrary is intertocked by default. You can override default 
actions by defining a tokmode variable in your profiles or by coding 
a fock or nolock key on the procedures as shown in the diagram on 
the next page. 


Interlocking of a base or library is done via an interlock file. 
Such a file must be a DIRECT access file in the same userc’s catalog 
as the base or libcary being updated. Naturally the interlock file 
must be a PUBLIC» WRITE MODE fite if other users are ftikely to be 
using it. The defauit name used by the SES source code maintenance 
and tibrary management procedures for the lock file is intrtok. You 
can have an interlock file of any name by defining the intriok 
profile variables or by coding a file name as a value for the tock 
parameter on the appropriate proceduress 
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Codeg Qo 
Procedure 


A Ne AA ED “AE AND ND A a ea 


Action Taken 
Pibcacy or base is ltocked regardiess of eOatenes of 
flokmode profile variable or other conditions. 
fibrary or base jis not locked regardless of contents 
of ftokmode eroreve variable or other conditions. 
a ee oe ae ae ae eae a ee ae ee a oe he ee ae ee Oe Ae a ee ae ee Oe Oe ae we ee ee oe ee 
Coded in Profile i Action Laken 
GH te ee AD AE NN He SN ED ND MD SN WON See emt ee sin ce ae ee A A A A SAN LS HS SO CN HN 
\ tokmode=*LOCK® i: tibrary or ~»base Ls locked 
; untess overridden by nolock 
; parameter on procedures 
oe a ae ae ae ee ee ae oe oe oe ee ee oe a oe ce ee ee ow 0 er ee ee ae ee ee re ee ee ee a ae 
\ lokmode="NOLOCK®! library or base is aati tocked 
$ untess overridden by fock 
$ paraneter on procedure, 
oo fe ef en fe a ee 
>; Quner Of Base : 
Nothing i Qc Library H Action Iaken 
ewe ee wee ee. ee ee 
: Current User i tibrary or base is not 
H : tocked untess the lokmode = 
H : profile variable is set 
H ; to "LOCK or the tock 
; : parameter is coded on the 
H $ procedure, 
$e a poe ee ee + 
+; Another lene :; Qibrary or base is locked 
H ; untess the lokmode 
H ; profile variable is set 
H ; to "NOLOCK® or the notock 
H : parameter is coded on the 
: } procedure 
OE  ——— eee eae oe ae ae ea — an me om 
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4e1 GETMO0_ QR. GETMODS -_ EXTRACT MODULE GROUP FROM BASE 


GETMOD and GETMODS are synonyms for a procedure designed to 
extract a designated group of modules (or all modules) from a MADIFY 
tibrarys and place the extracted modules on a MADIFY “source” format 
files, that iss each extracted modute occupies one togical record on 
the “source™ file. Parameters to GETMOD(S) are 3: 


mor ail: 
Coding the all key indicates that ALL modules are to be 
extracted from the specified base. The m parameter refers 
to a modute or ftist of modules to be extracted. Ranges of 
modules may also be specified. 


g or group : 

(optionai) name of file to receive the modufes extracted 
from the basee If you don't code the g parameters 
GETMOD(S) uses the value of profile variable group as the 
group fife names and if there's no such variable defineds 
GETMOD(S) uses the name group as the name of the group 
file. See the note on GROUP files at the beginning of 
this section. 


bor | 3 
{optional) name of Base Library from which modules are to 
be extracted. If you don't code the b parameters 
GETMOQD(S) uses the value of profile variable base as the 
name of the base ftibrarys and if there's no such variable 
defined, GETMOD(S) uses the name base. 


(optional) User Name in whose catalog the base specified 
by b is to be founds if b is not in the catalog of the 
current usefre If you don't code the un parameters 
GETMOD(S) uses the vatue of profile variable baseown as 
the user name from whose catalog the base is to be 
obtaineds and if therets no such variable defineds 
GETMOD(S) uses the current user's catalog. 


cors or c : 
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(optional) is a File containing a CORrection Set to be 
applied against the base b before the module m “is 
extracted. If you code this parameters SES ovrocedure 
TEMPCOR is used to apply a TEMPorary CORrection set. Note 
that TEMPCOR doesn*t actually aiter the base» the 
correction set is only applied for the duration of the 
GETMOD(S) run. 


wor width 3:. 
{optional) maximum Width of modules retrieved. 


status or sts : 

status is an (optional) parameter that can be used for 
those cases where GETMOD{S) is being used as a building 
block of more sophisticated procedures or jobs. The 
status parameter causes GETMDD(S) to set one of the job 
control registers to the vatue zero if GETMOD{(S)}) 
successfully compteteds and to non zero if anything went 
wrong during the run of GETMOD(S). The only values that 
may be coded for the status parameter are one of Ris R2» 
R3 or EF. Any other value coded causes an error message 
to be outputs and the GETMOD(S) procedure aborted. 


msg or nomsg ?. 
these {ootional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.28 — "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 


Examptes of GETMOD(S) Usage 


sesegetmods (outtinds ltimitsdea-oprtypks ststypks symentdeesymk) 
* END GETMODS GROUP <= BASE 


This example shows GETMODS used to extract a bunch of modutes from a 
base. Modules outtinds ali modules ltimitsd through oprtypks module 
ststypk», and ali modules symentd through symk are extracted. Every 
parameter to GETMGDS is set to its default vatiue. The modules 
appear on the file group. 
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sesegetmods ali becidbase un=z=dt73 g= junk 
* END GETMODS JUNK <= CIOBASE 


This example extracts ALL modules from base cidbase in the catalog 
of user dt73 onto a group file junk 


Note : A possible method of using this procedure is to extract a 
group of modules using GETMODSs to edit those modules using MULTED» 
and finalty to replace the modules in the base fibrary using 
REPMOD. For example 3: 


sesegetmods all bz=cidbase; mutted; repmods b=cidbase 
The exampte gets ait modutes from base cidbases uses procedure 


MULTED to edit the group file (MULTED"®s default input file name is 
group)» then replaces al! the modules on cidbase again. 
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Dataflow of GEIMOD(S) usage 


$$ ww eee wow www } 


PES LEST ETT SE ES ET / $ VRBTSTAAALaAwcezex 
$aa-s- ne --- +} GROUP 
BASE -------- ------- >! GETMOD(S) $-}----------->(extracted 
: (extract §: + modules) 
RRARSSTTLSAAws ee $ modules) 3/ STRRVRARTSBARzS 
toeore-= a met 
H 
; 
; 
SSRIS esze 8s ; 
CORS : 
{correction sere r error nnn nt 
sets) 


GETM9D(S) is a fairly simpie process : a fist of modules is 
extracted from the base Llibrarys and appear on file group in MADIFY 
source forms that Is» one module per fogical record. An optional 
correction set (the cors parameter) may be applied temporarity to 
the base before the modules are extracted. Procedure TEMPCOR 
applies the temporary correction sets. 
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4e2 REPMOD.O8 REPMODS _-_ADD. OR _ REPLACE MODULES 


REP MOD and REPMODS are synonyms for a procedure for adding or 
replacing modulte{s) on a base.» Parameters to REPMOD(S) are 3: 


(optional) tist of Modules to be added to or replaced on 
the bases If you don't code the m parameters REPMOD(S) 
assumes that the modulte(s) to be added or replaced are on 
the group file specified by the g parameter. Note that 
each file specified by the m parameter is treated as a 
MADIFY source file for "group" file) with exactily one 
module on it. See the note on GROUP files at the 
beginning of this section. 


g or group :. 
(optional) name of the group file to be used to accumulate 
the modules. If you don't code the g parameters REPMOD(S) 
uses the value of profile variable group as the group file 
names and if there's no such variable defineds REPMOD(S) 
uses the name group for the group file. See the note on 
GROUP files at the beginning of this section. 


bor ft: 
(optional) name of Base Library to be updated. If you 
don't code the b parameters REPMDD(S) uses the value of 
profile variable base as the name of the base tibrarys and 
if there's no such variable defineds REPMOD{S) uses the 
name base@e 


nb or ni 3 
{optional) name of the New Base to receive the updated 
fibrary.e If you don't code the nb parameters REPMOD(S) 
uses the vaiue of profile variable newbase as the name _ of 
the new base tibrary» and if there's no such variable 
defineds REPMOD(S) uses the name of the base tibrary 
specified by the b parameter. 


un 3 
{optionai) User Name in whose catalog the base specified 
by b/nb is to be founds if b/nb is not in the catalog of 
the current user. If you don't code the un parameter» 
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REPMOD(S) uses the value of profile variable baseown as 
the user name from whose catatog the base is to be 
obtaineds, and if there's no such variable defined>s 
REPMODD(S) uses the current user's catalog. 


“« or width or inwidth : 
(optional) maximum Width of the input modules. 


fock or notock : 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the interlock file. Intertocking is the default 
action when the base being updated is in another user's 
catalog. If you don*t code either of the tock or nolock 
keys» interlocking is controitted by the flokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the flock and notock parameters. If 
you don't code a filename for the flock parameters the 
contents of profile variabte intriok is used as the 
intertfock filename; if there's no such profile variables 
the name intriok is used as the tock filename. The 
interlock file mpust be in the same catalog as the base 
being updated. If the iIntertock file cannot be founds the 
procedure aborts. 


batch job parameters ; 
These parameters are described in section 1.27 - “SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in focal modes but it can be run in 
batch mode. The dayfile parameter is not used by this 
procedure. 


mSQ or nomsg : 
these (optional) keys control! the generation of 
informative messages by this procedure and are “fully 
described in section 1.8 —- “INFORMATIVE MESSAGES FROM SES 
PROCEDURES”. 
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Examptes of REPMODD(S) Usage 


seserepmod (Chertzs maxwetis marconi)s b=z=radios nomsg 
* END REPMOD GROUP => RADIO 


This exampie shows three modules being collected onto aie group 
File group (the default)» replaced on the base called radio. Since 
the nomsg key is codeds no informative messages are output during 
the run of REPMOD. 


seserepmods (grabs hoid) bz=ziitch g=temp w=80 lock msg 
GRAB -> TEMP 

HOLD -> TEMP 

LOCKING ZILCH VIA INTRLOK 

ZILCH LOCKED 

REPLACING/ADDING MODULES ON ZILCH 
NEW BASE ON SESTMPB 

NEW BASE NOW ON ZILCH 

SESTMPB PURGED 

BASE ZILCH UNLOCKED 

END REPMODS TEMP =-> ZILCH 


++ RHRHeH HHH 


This example shows two modules being replaced on the base 2iich 
through a group file temp. The width of the input tines is timited 
to 80 (ASCII) characters (because of the w parameter). Because the 
lock key was codeds the base is tocked during the run using file 
intrtok (the default). Informative messages are output during the 
REPMODS run because the msg key was coded. 
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Greatinga.aNew Base with REPMODIS) 


If you are creating a brand new base from scratchs you use 
REPMOD(S) stlightty differentiy from the normal cases in that you 
code ab (base) parameter and an nb (new base) parameters but the b 
parameter refers to a non existent bases as in this example : 


seserepmods (yorkshunt) bznonsuch nbzneustuf 
YORK => GROUP 

HUNT =-> GROUP 

CREATING NEW BASE NEWSTUF 

NEW BASE ON NEWSTUF 

END REPMODS GROUP => NEWSTUF 


tt et 


COMPANY PRIVATE 


4-19 
CDC - SOFTWARE ENGINEERING SERVICES 
7/30/81 
SES (Release 17) Userts Handbook REV: AB one 
4.0 SOURCE TEXT MAINTENANCE 
4s 2 REPMQD GR REPMODS - ADO OR REPLACE MODULES 


Data_flow_of REPMOD(S) processes 


ZSEBESVALSA*AseTeZezw2s sa 
GROUP 
(file of 

modules) 


BSBBISSSIUsETsTzI=S 


eG a8 BO 


Forme Fem ment 
/ y 3 SRBRSAsAssSssestF 
$oeeee meme } fj NB 
§ REPMOD(S) j-te-n—-------> (new base) 
troeweweronmmeenm——=—>i {replace  : + 
; modules) 3 


/ SSVI eseseswesz2z222 


B 


base 


VSESSSRLSVECISszEASE 


BG GS 26 £6 Oo 4O BO 
* 


REPMOD(S) takes moduftes from a group file (whichs as shown in the 
diagrams coutd wet! have come from the oid base in the first place)s 
and replaces (or adds) them to produce either a completely new bases 
or rewrites the result over the old base. 
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403 COLLECT =_COLLECT MODULE(S)_TO_BUILO_A_GROUP_FILE 


COLLECT is useful in. conjunction with source text maintenance 
procedures such as REPMOD(S). COLLECT buitds a group file by 
COLLECTing modules of a specified types adding in the module name 
and COMMON ftiness and copying the modules to a group file. Aiso» 
COLLECT can accumulate members of different types onto the group 
files and so may be used in conjunction with the library management 
procedures described in another section. Parameters to COLLECT 
are 3 


@ or mem or mems or member or members : 

(eptional) tist of Members to be accumuiated onto the 
group file. When used in conjunction with other Source 
Code Maintenance proceduress COLLECT assumes that files 
specified with the m parameter already have the deck name 
as the first fine of the file (and COMMON as the second 
fine for a common deck). Note : if the file specified by 
the m parameter is a mufti record files COLLECT does 
gather all records in the file. This capability is pot 
available with the c and fr parameters as it is not truly 
applicable in those cases-e 


c or com or opic : 
(optional) tist of COMmon modutes to be accumulated onto 
the group file. COLLECT assumes that such modules are 
straight text files» and so COLLECT places the modute name 
and COMMON tines at the start of the module. 


r or reg or opi 3 
(optional) fist of REGular modules to be accumusated onto 
the group file. COLLECT assumes that such modules are 
straight text files» and so COLLECT piaces the module name 
fine at the start of the module. 


g or group : 
(optional) name of group file onto which the member(s) or 
modufle(s) are to be accumulated. If you don't code the g 
parameters COLLECT uses the vatue of profile variabte 
groups and if there's no such variable defined in your 
profile, COLLECT uses the filename group. 
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msg or nomsg ; 


these {optional) Keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES"™. 


Examptes of COLLECT Usage 


sesecollect czcdcs icis ibm)s r= (sdces ifss csc)s gzacronym 


+e et HH 


COC/COM -> ACRONYM 
ICL/COM -> ACRONYM 
IBM/CGM -> ACRONYM 
SDC/REG -—> ACRONYM 
IFS/REG -> ACRONYMS 
CSC/REG -> ACRONYM 
END COLLECT ACRONYM 


This example shows six straight text files being collected onto a 
aroup file acronym. The first three are specified as common modules 


(the 


c parameter)s so COLLECT adds the modute name and COMMON lines 


at the front of the file before adding it to the group file. The 


fast 


three are specified as reguiar modules (the fr parameter)s so 


COLLECT adds the modute name tine at the start of each one before 


adding 


it to the group file. 
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Rata._flow.of COLLECT processing 


.- + + 2 £2 Fs 2 £ FS 2 2 S +3 | oes FF to 2 t Fo So FF 4 
R or REG or OPL C (COM or OPLC) 
COGUt 6, SSS S36 eS9 eee ee" + tS Sees een eee: CORON 
modules modules 


RBRREEBZRTSSSASLSABSEBE SBTESETSBZITSEBSLESSUAE 


ao 26 SO O6 


ee oo oe | 
/ Vv Vai 
$n wwe nw eee + 3 
: COLLECT $3 $ 
; (make a } + 
: group) Ht 
Fee ee $e —+ 
H 
H 
V 
fe 2 e+ FEES EE SF S + FS 3 
G or GROUP 
file containing 
modules 


As shown in the diagram», COLLECT takes files designated as either 
regular or common moduless and gathers them onto a group file. 
COLLECT can also just gather up records which already have header 
information in them (the m parameter). 


COMPANY PRIVATE 


4-23 
CDC - SOFTWARE ENGINEERING SERVICES 
7/30/81 
4.0 SOURCE TEXT MAINTENANCE 
4a GENCOMP - GENERATE COMPILE FILE FOR MODULE(S) 


PO PEO DE AE AO OE OD O89 0 F8 FE AO FE PEPE OE PE PE PO PE 18 OO 08 28 PE PO PE FE FE OE PE PE 88 08 OO OE RE PO OE OE 98 OE 20 PE 08 RE PE OE PO PE OE TE OE PS FO FE 98 08 FE OE 10 FE PE 8 88 8 Oe 


4e4 GENCOMP = GENERATE COMPILE _EILE_FOR MODULE(S) 


GENCOMP generates a compile file for a module or a group of 
modules. OQniy regular modules can be GENCOMPed. The GENCOMP 
process resolves calis to common modules (including nested calls) 
according to the following “compite file" directives 3: 


*CALL modute . 
This directive unconditionally cails the specified common 
module. 


*CALLC module 
This directive only calls the specified common module if 
it has not already been cailfed within the current regular 
modute. The information about which common modules have 
been called is cleared at the end of processing each 
reguiar modute,. 


*IFCALL name module 
This directive only calis the specified common module if 
the specified name has been defined (see the define 
parameter described below). 


*¥NIFCALL name module 
This directive onty caltts the specified common modute if 
the specified name has not been defined (see the define 
parameter described below). 


GENCOMP permits the specification of a tist of aiternate bases 
from which to resolve common deck calls (or in which to find modutes 
to be GENCOMPed). Also»s a source fite may be specified which 
contains source for modules (or common modules) to be used in the 
GENCOMP processe In additions correction sets may be applied prior 
to the compite file being generated. 


When generating the compile files MADIFY searches for decks in 
the following order 3 


le. If the SF parameter ts codeds the specified file is searched. 

2¢ If the AB parameter is codeds the specified files are searched 
from right to left. 

3. If the CYBCCMN/CYBICMN parameter is codeds the designated 
common deck base is searched. 

4. Finallys the base specified by the 8 parameter is searched. 
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Parameters to GENCOMP are 3: 


moor ail 


cf ; 


bo oor !} 


un 3 


ab or al 


This (optional) parameter specifies a list of modules 
{including ranges of modules) For which the compite file 
is to be generated. If the atl key is codeds a compile 
fite for ALL of the (regular) modutes in the specified 
base(s) are produced. If you don't code the m parameter 
at alls you must code the sf parameter (see below). 


(optional) name of the Compile File to be generated. If 
you don't code the cf parameters GENCOMP writes the 
compile file to a file called compile. 


{optional) name of Base Library from which to generate the 
compite file. If you don't code the b parameters GENCOMP 
uses the value of profite variabie base as the name of the 
base iibrarys and if there's no such variable defineds 
GENCOMP uses the name base. 


(optional) User Name in whose catalog the base specified 
by b may be found. If you don't code the un parameters 
GENCOMP uses the value of profile variable baseown as the 
name of the base tibrarys and if there's no such variable 
defineds GENCOMP assumes that the base is in the current 
user's catalog. 


: 

{optional) fist of Aiternate Bases from which to satisfy 
calis to common modules. The ab parameter may be coded as 
a multi vatued tist of subtists. Each element of the 
vaiue tist is either ae single names in which case it 
refers to the name of an alternate base already assigned 
to the job» or in the current user's catalogs or an 
efement is a sublists in which cases the last sub element 
in the sublist is a user name in whose cataitog the bases 
referred to by the other sub elements of the sublist may 
be found. The exampte at the end of this description 
should (with tuck) make this clear. 
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400 SOURCE TEXT MAINTENANCE 
424 GENCOMP ~- GENERATE COMPILE FILE FOR MODULE(S) 


sf : 


cors or 


foptional) name of a Source File containing source text 
for one or more modules or common modutes that are to be 
used in piace of or in addition to the modutes on the 
specified base{s). If the sf parameter is givens the file 
it specifies is the object of a *CREATE directive to 
MADIFY. Note =: that if you don*t code the m parameter 
{described above)» GENCOMP assumes that the file specified 
by the sf parameter contains one (regular) module and 
thats uniike the normal case for a MADIFY source modules 
its first line is not the module name but is the first 
line of data in the module (in this case a default module 
name of SESGPT is used). If you don't code the sf 
parameters you must code the m parameter. 


c 3) 

{optional) name of file containing CORrection Sets to be 
temporarity applied against the base b prior to generating 
the compile file. If you code the cors parameters GENCOMP 
uses procedure TEMPCOR to make the temporary corrections 
before generating the compile file. 


seq or noseq ? 


(optional) The default for GENCOMP is NO SEQence numbers 
on the compite files and a compite file width of 100 
(ASCII) characters. You can code noseqsyatue to change 
the widths or you can code seq to get S$EQuence numbers at 
a width of 100 characterss or you can code seqzevalue to 
get SEQuence numbers at compite file width of vatue 
characters. You control the sequence numbers and width by 
defining the orofile variables cfseq and cfwidth. 


define or def : 


this Coptional) parameter specifies a name or tist of 
names to be ¥*DEFINEd for reference by the *IFCALL and 
*NIFCALL “compite file” directives described above. 


status or sts : 


status is an (optional) parameter that is used for those 
cases where GENCOMP is being used as a building block of 
more sophisticated procedures or jobs. The status 
parameter causes GENCOMP to set one of the job contro! 
registers to the value zero if GENCOMP successfully 
completeds and non zero if anything went wrong during the 
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420 SOURCE TEXT MAINTENANCE 
424 GENCOMP = GENERATE COMPILE FILE FOR MODULES) 


cybccan 


nest or 


run of GENCOMP. The only values that may be coded for the 
status parameter are one of Rls R2» R3 or EF. Any other 
value coded causes an error message to be outputs and 
GENCOMP procedure aborted. 


or cybicmn :3 

these {optional) keys specify one of SES supplied 
Aiternate Bases for use in satisfying caiis to common 
modules (see the ab parameter described above). If you 
code the cybccmn keys the base containing CoMmoN moduies 
for use by CYBIL CC programs is selected. If you code the 
cybicmn key» the base containing CoMmon modules for use by 
CYBIL CI programs is selected. If you don't code either 
of these keys» neither of the corresponding bases is 
selected for use in generating the compile file. 


nonest : 

these (optional) keys contro! whether nested cails to 
common modules are processed or ignored. If you omit this 
parameter or code the nest keys GENCOMP processes nested 
calis to common decks. If you code the nonest key GENCOMP 
treats nested calis as ordinary tines of text. 


msg or nomsg : 


nodrop 


these (optional) keys contro! the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 


if this (optional) key is codeds it specifies that an 
®unknown™ common deck (one that couldn?t be found during 
the compile file generation? is not considered to be an 


errors otherwise it is. Note 3: other errors are also 


ignored if nodrop is givens so use this feature at your 
own riske 
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Examples of GENCOMP Usage 


sessgencomp nexiinr 
* GENERATING COMPILE FILE NEXLINR 
* END GENCOMP COMPILE <= DURBASE. 


This exampie shows the simplest use of GENCOMPs generating a 
compile file for a module nextinr. Since the m parameter of GENCOMP 
is the first positional parameters we can omit the m keyword. There 
is no base specified in the exampte since there is a directive 
fike 3: 


\ base = "QURBASE® 


in our profile. When GENCOMP has finisheds the generated compile 
file appears on the file compile. The next example is more 
complicateds it shows the use of multipie modules and aiternate 
bases used to generate the compile file. 


sesegencomp (Casterixs obelixeegetafixids bzgauls abzs(haspseces 
ee? (grasps cicss powers 1r69)s milos) 

* GENERATING COMPILE FILE COMPILE. 

* END GENCOMP COMPILE <= GAUL 


This example generates a compife file for modules asterixs and 
all moduies obetix through getafix in the base catied gauf. 
Alternate bases hasp and miftlos are to be obtained from the current 
user's catalogs» and alternate pases grasp» cics and power are to be 
obtained from the catalog of user 8f£69. The compite file appears on 
file compiie. The exampite also iftflustrates the use of continuation. 
liness showing the multi valued ab parameter split across fines. 


sesegetmods (specials general)» bztheorys; multeds es 
ee? gencomp (specials generat)» cfzalberts sfz=groups e- 
eo? betheorys defineziorentzs seqz79 

* GENERATING COMPILE FILE ALBERT 

* END GENCOMP ALBERT <- THEORY 


In this exampie modules speciat and general are extracted from 
base theory onto file group and edited. Then a compite file is 
generated for the edited version of the modules (via the sf 
parameter) with the forentz “option” defined. The resulting file 
albert will have sequencing information to the right of column 79. 
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Dataflow of GENCOMP usage 


SERRBESAATSSSzs SERSRALSATAAzAA 
B SF 
base containing ------------- ~+t Homer en nam file containing 
modules ; ; source modules 
RLS eeess ze + 3 REBEL BATA a2zse8 
; ; 
; H 
$ : 
Foe foeemon foot 
SIASCLSTcLSsAsSsesasz / Vv V 73 RSARSSSBSALASSVTcE 
AB $—--=------- + 3 CF 
(alternate ---------- ->3 it icewmnm—----> (compile 
bases) 3 GENCOMP 3; + | file) 
RSASREETASABAAeZ $ 3/ SSERSASABEESAze 
toe nnn oe | 
; 
; 
; 
RRSECTIBAeseaze 4 
CORS H 
tespotary ssssSesn-- He SS-= + 


correction sets 


RBBSTFTIA**SIS“*ASSATTS 


GENCOMP generates a compile file for modutes which may come from 
off the base (the m parameter)» or from a source file (the sf 
parameter)» or from both ptaces. The ab parameter specifies a tist 
of alternate bases to be used to get common decks from. A temporary 
correction set may be applied (the cors parameter) via the TEMPCOR 
procedure before generating the compile file. 
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4-5 GENCOR_08_GENCORS = GENERATE CORRECTION SETS 


GENCOR and GENCORS are synonyms for a procedure that GENerates a 
CORrection Set for a module. Parameters to GENCOR{S) are 3 


name of the Modute within the base library b for which the 
correction set is to be generated. Alsos mis the default 
name of the file (either tocal or in your catatog) which 
contains the new version of the modufe {see the sf 
parameter described below). 


bor i 3 
(optional) name of Base containing the module specified by 
m for which the correction set is to be generated. If you 
don't code the b parameters GENCOR(S) uses the vaiue of 
profite variable base as the name of the base Jibrarys and 
if there's no such variable defineds GENCOR(S) uses the 
name base. 


(optional) User Name where the base fibrary specified by b 
is to be found. If you don’t code the un parameters 
GENCOR(S) uses the value of profile variable baseown as 
the user name in whose catalog b is to be founds and if 
there's no such variable defineds GENCOR{S) assumes that 
the base ftibrary is in the current user's catalog. 


cors or c 3 

{optional) is a file containing a CORrection Set to be 
applied against the base b before the moduie om _  =is 
extracted. If you code this parameters SES oprocedure 
TEMPCOR is used to apply a TEMPorary CORrection set. Note 
that TEMPCOR doesn't actuality atter the bases the 
correction set is only applied for the duration of the 
GENCORS rune 


ncors or nc ; 
(optional) name of file to receive the New CORrection 
Sete If you dontt code the ne parameters, GENCOR(S) uses 
the name necors for the new correction set file. 
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id 


sf 


ts 


fi 


or 


(optional) IDent name for the GENCGRS ¥*IDENT directive in 
the generated correction set. id can be any character 
string that forms a valid MODIFY correction identifier. 
If you don't code the id parameters GENCORS generates a 
unique correction set identifier, 


this f{optional) parameter specifies the name of the file 
containing the new version of the module. If you dontft 
code the sf parameters GENCOR(S) uses the name specified 
by the m parameter as the Source File name, 


ignorts : 
these (optional) keys specify whether or not to JIGNORe 
Leading Spaces on lines being compared. The default action 
jis to recognize leading spaces (the Is option). If you 
code the ignorits keys GENCOR(S) ignores leading spaces on 
text lines. 


(optional) parameter to increase the field length. If you 
don't code the £] parameters GENCOR(S) defaults to a field 
fength of 100K. 


msg or nomsg : 


these (optional) keys control the qeneration of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES", 


Exampie of GENCOR({S) Usage 


sesegencors mzenices b=zneats unzby73»s neczcorset 


GENERATING CORRECTION SET FOR NICE ON CORSET 
END GENCORS NICE -> CORSET 


This example shows 2 correction set being generated for module 


nice. 
by73. 


The original modute is in base neat in the catalog of user 
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Data_flaw.of GENCOR (S$) 


SRSESSLSTSAA“ASAISTAS 
M 

file containing ~e3--rer nnn nt 

new module 


<< 08 we ww «4 oe 


= ¢= eon eet 
Ree scserse2ses 22 / 73 SSRTSARTAEBSTAAE 
B ponnnnn nnn e | NCORS 


Base containing ------->i 3 


ry 
otd module #->:i GENCOR(S) $ 
5 


SSTSEBSERSASwTIABBA=S 


+ correction set) 
; j RVeeesee2zazr22ae2s 


SBVVTSCSATVISAEtESZ 
cORS 
(temporary -------- 


correction set) 
So 2 2 2S SS eS & ES Sf Fs 3 


> 66 66 co a6 He oe we 


The picture shows the flow of GENCOR(S). The file containing the 
new module M is in the user's catalog. The old version of the 
module is in the base 8B-e An optional temporary correction set 
{CORS) may be applied if desireds in which case GENCOR(S) uses the 
TEMPCOR procedure to apply the correction set before generating the 
new correction sets which appears on the file specified by the ncors 
parameter. 
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%o6 TEMPCOR -_ MAKE TEMPORARY CORRECTIONS 1O_BASE 


TEMPCOR makes temporary corrections to a base tibrarys without 
permanently updating the Jlibrarys providing checkout of the 
corrections applied before permanent modifications are wmadee 
Parameters to TEMPCOR are : 


bor | 3 
name of Base Library against which the corrections are to 
be applied. If you dontt code the b parameters TEMPCOR 
uses the value of profile variable base as the name of the 
base librarys and if there's no such variable defineds 
TEMPCOR uses the name base. 


un 3 
(optional) User Name in whose catalog the base tibrary 
specified by b may be found. If you don't code the un 
parameters, TEMPCOR uses the value of profile variable 
baseown as the user name where b may be founds and if 
there?ss no such variable defineds TEMPCOR uses the current 
user’s catalog. 


cors or c 3 
name of file containing the CORectionS to be applied 
against b. 


msg or nomsg :3 
these {optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 —- "INFORMATIVE MESSAGES FROM SES 
PROCEDURES”. 
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Exampie of TEMPCOR Usage 


sesetempcor behisbases unznr06s czcorsets 
* CREATING TEMPORARY BASE 

* TEMPORARY BASE NOW BEING USED 

* END TEMPCOR CORSETS => HISBASE 


This example shows the correction set corsets being applied to 
the base hisbasee The base hisbase is teft local to the jobs such 
that further references to hisbase actually use a temporary copys 
and not the ortginal. . 
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Se7 MODIFY = UPDATE. ___ BASE WITH CORRECTION _ SET(S) 


MODIFY is intended to take a correction set file and update a 
base library with the correction sets contained therein. Parameters 
to MODIFY are 3: 


cors or c or i 3 
name of fife containing the CORrection Seti{s) to be 
applied against the base specified by the b parameter. If 
you don't code the cors parameters MODIFY uses the name 
corss. 


bor { 2. 
(optional) name of Base to be updated from the correction 
set file. If you don't code the b parameters MODIFY uses 
the value of profile variable base as the name of the 
bases and if there's no such variable defined» MODIFY uses 
the default name base. 


nb or nt: 
(optional) name of New Base to be created when the update 
has been completed. If you don*t code the nb parameters 
MODIFY uses the vatue of profile variable newbase as the 
name of the new bases and if there'ts no such variable 
defined, MODIFY writes the new base over the old base 
specified by the b parameter. 


oe 


un 
(optional) User Name in whose catalog the base specified 
by b/nb is to be founds if b/nb is not in the catatog of 
the current user. If you don't code the un parameters 
MODIFY uses the value of profile variable baseown as the 
user name from whose cataiog the base is to be obtaineds 
and if there's no such variable defineds MODIFY uses the 
current user's catatog. 


fock or nolock 3 
these {optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the intertock file. Interlocking is the default 
action when the base being updated is in another user's 
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catatog. If you don't code either of the tock or nolock 


KEYS» intertocking is controlied 


by the ftokmode profile 


variable. Refer to the introductory sections of this 
chapter for information on the interactions of the ftokmode 
profile variabte and the lock and nofock parameters. If 
you don't code a filename for the tock parameters the 
contents of profile variable intriok is used asthe 
interlock filename; if there's no such profile variables 


the name intr tok is used as the 


fock filename, The 


interlock file must be in the same catalog as the base 
being updated. If the interlock file cannot be founds the 


procedure aborts. 


batch job parameters : 


These parameters are described in 


section 1-7 - "SES 


PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in tocal modes but it can be run In 


batch mode. The dayfite parameter is 


procedure. 


msg or nomsg : 
these (optional) keys control 


not used by this 


the generation of 


informative messages by this procedure and are fully 
described in section 1.28 - "INFORMATIVE MESSAGES FROM SES 


PROCEDURES”. 


Example of MODIFY Usage 


sesemodify b=dusbase czcorstib 
APPLYING CORSLIB TO DUSBASE 
NEW BASE ON SESTMPB 

NEW BASE NOW ON DUSBASE 
SESTMPB PURGED | 

END MODIFY CORSLIB -> DUSBASE 


etree te & 


This examole shows a correction set file called corstib applied 


against a base tibrary called dusbase. 
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408 CATBASE =_PRODUCE _LIST_OF MODULES _IN_A_BASE LIBRARY 


CATBASE is used to display ae tist of the modules in a base 
library. CATBASE outputs the modules tist in a condensed formats 
four modules per tines showing only the module names and their 
type. Parameters to CATBASE are 3 


bor § 3. 
(optional) name of Base Library which is to have its 
modufe names displayed. If you don't code the 0b 
parameters CATBASE uses the value of profile variabie base 
as the name of the bases and if there's no such variable 
defineds CATBASE uses a file name of base. 


un 3 
(optional) User Name in whose catatog the base specified 
by the b parameter is to be found. If you don’t code the 
un parameters CATBASE uses the vaiue of profiite variable 
baseown as the user names and if there's no such variable 
defineds CATBASE uses the current user's catalog. 

o 3: 


{optional) name of file to receive the Qutput from 
CATBASE. If you don*t code the o parameters CATBASE 
places the module tist on fite output. 


short or tong : 
these (optional) keys determine the format of the output 
from CATBASE. If you omit this parameter or code the 
short keys CATBASE produces its output in the form shown 
in the example below. If you code the fong keys CATBASE 
produces its output in the same format as the NOS wtitity 
CATALOG. 
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Example of CATBASE Usage 


sesecatbase b=dusbase unzvb55 


* 


Cc 


DOUSERM. »-OPL 

DUSCODM.-OPLC 
DUTEXTP..OPLC 
DUGOODY..OPLC 


DUSYNTX.-eOPLC | 


DUUPDAT.-OPLC 


DUINTRO..OPLC 
DULIBRM..OPLC 
DUMAILB.-OPLC 
DUPROFL..OPLC 
DUAQUIR.~-OPLC 
ODPL eceee ce DPLD 


END CATBASE DUSBASE 


DUPRINT. -OPLC 
DUFILEM.-OPLC 
DUMULTI.-eOPLC 
DUMODES.-OPLC 
DUXTRAC*s -OPLC 
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DUFORMT.-OPLC 
DUCOMPL.-O0PLC 
DUCONVS..OPLC 
DUMESGS..OPLC 
DUDOMSG..OPLC 


This example shows CATBASE output for base tibrary dusbase in the 


atalog of 


user 


vb55. 


Regular modules are identified by the type 


code OPL» and common modules are identified by the type code OPLC. 
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4e9 LISTMOD.-_ LIST CONTENTS _OF_BASE 


LISTMGD performs two main functions : to show you what's in a 
bases and to get a printout of the modules in the base if 
necess ar ye LISTMOD first generates across reference of the bases 
showing which modutes cai! which modules» and which modules are 
called by which modutes (LISTMOD uses procedure XREFMOD to generate 
the cross reference - see the description of XREFMOD if you're 
interested). Lastlys LISTMOD generates a printout of al! modules or 
common nodules in the base--you can suppress this if you onty want 
the cross reference without the whole base's contents. Parameters 
to LISTMOD are 3: 


bor ? 3: 
{optional) name of Base to be processed. If you don't 
code the b parameters LISTMOD uses the value of profile 
variable bases and if there*s no such variable defineds 
LISTMGD uses the default name base. 


03 
{optional) name of file to receive the Qutput from 
LISTMOD. If you don't code the o parameters a sceratch 
file is used for the output and is returned once it has 
benn printed. If you code the o parameter and LISTMOD is 
run in tocal modes the output is placed on the specified 
file and is not printed untess the print parameter is 
givens 

un 3 


(optionat) User Name in whose cataiog the base specified 
by b is to be found. If you don't code the un parameters 
LISTMGD uses the value of profile variable baseowns and if 
there's no such variable defineds LISTMOD uses the user 
name of the current user. 


batch job parameters : 
These parameters are described in section 1.27 - "SES 
PROCEDURES RUN AS BATCH JOBS". The defauit for this 
procedure is to run in batch modes but It can be run in 
focal mode. The dayfile parameter is not used by this 
procedure. 
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print ; 
(optional) indicates how the output of LISTMOD is to be 
printed. For the print parameter you may code any of the 
parameters to procedure PRINT. If you don*t code the 
print parameter at alls LISTMOD prints one (1) copy of the 
output on the ASCII printer. 


short or common ° 

these (optional) keys control which modules are tisted 
following the cross reference of the base. If you omit 
this parameter, LISTMOD tists the source for all modules 
in the base. If you code the common keys LISTMOD tists 
onity the common modules from the base. If you code the 
short keys no modules are listed (1.2ee. onty the cross 
reference is produced). 


Examptes of LISTMOD Usage 


seselistmod print=copies=3» short 
11.17234e¢ SUBMIT COMPLETE. JOBNAME IS AVOPBUG 
* JOB LISTMGD SUBMITTED 


This example shows LISTMOD processing the base whose name is 
contained in profile variable base. Three copies of the short fist 
(cross reference onty) are produced. LISTMOD is run in batchs 
rather than interactivety. Running LISTMGD in batch is the 
preferred modes since it uses rather a targe amount of resources.e 


seselistmod bzcidbases oxzcidprinserccsee 

ee? printz(copies=2s h="*tatest/version of/cidbase!) 
10.19-57. SUBMIT COMPLETE. JOBNAME IS ACULBXG 

* JOB LISTMOD SUBMITTED 


This example shows LISTMOD run in batch to produce two printouts 
of the cross reference of base cidbase»s plus the text of ail the 
modules in cidbase. 
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4010 SORIMQ0_=_302T_ BASE_INIO_ ALPHABETICAL ORDER 


SORTMOD rearranges a base such that all the modules appear in the 
base in alphabetical order. This is a very useful facilitys for 
when a base becomes targe and has a targe number of modules in its 
it's easier to find modules in the base if theytre in some regular 
order. Parameters to SORTMOD are :. 


bor ft 3 
(optional) name of Base to be sorted. If you don't code 
the b parameter, SORTMOD uses the vaiue of orofitle 
variable bases and if there's no such profile variable 
defineds SORTMOD uses the name base. 


nb or nl 2? 
(optional) name of New Base to be created at the end of 
the SORTMOD run. if you don't code the nb parameters 
SORTMOD the vatue of profile vartiabte newbase. If there's 
no such profile variable defineds SORTMOD writes the new 
base on the file specified by the b parameter. 


un 3: 
(ootional) User Name in whose catalog the base specified 
by b/nb is to be Founds if b/nb is not In the catalog of 
the current user. If you don’t code the un parameters 
SORTMOD uses the vaiue of profite variabie baseown as the 
user name from whose catalog the base is to be obtaineds 
and if there's no such variable defineds SORTMOD uses the 
current user's catalog. 


(optional) name of file to receive the Output of the 
programs used to run SORTMODO. If you don't code the o 
parameters SORTMOD sets 020» or no output. This is 
usuaily the desirabte defauits since the sort process 
generates large volumes of output. 


edtsort : 
{optional) pair of filenames representing the input and 
output fites for the EDT text editor. You use edtsort to 
EDIT the SORT output to impose your own ordering on the 
modufes in the base. 
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fock or noflock 2 

these {optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the intertock file. Interlocking is the default 
action when the base being updated is in another user's 
catalog. If you don't code either of the tock or =notlock 
keys» interlocking ts controlted by the tokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the tock and notock parameters. If 
you: don't code a filename for the tock parameters the 
contents of profile variabte intriok is used as the 
interlock filename; if therets no such profile variables 
the name intriok is used as the tock filename. The 
interlock file must be in the same cataiog as the base 
being updated. If the interlock file cannot be founds the 
procedure aborts, 


batch job parameters : 
These parameters are described in section 1.27 - "SES 
PROCEDURES RUN AS BATCH JG8S". The default for this 
procedure is to run in Jocal modes but it can be run in 
batch mode. The dayfile parameter is not used by this 
procedure. 


msg or nomsg ;: 
these (optional) keys contro) the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES™,. 
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4e11 WIPEMOO.=-_DELETE MODULES) _ FROM BASE 


WIPEMOD is intended as a means of deleting modulets) from a 
base. Parameters to WIPEMOD are ; 


bor ft 3 
{optional) name of Base from which module(s) are to be 
deleted. If you dontt code the b parameters WIPEMOD uses 
the vaiue of profile variable base as the name of the 
base@e If there's no such profile variabte defineds 
WIPEMOD uses the name base as the name of the base. 


nb or ni: 
(optional) name of New Base to be created at the end of 
the WIPEMOD run. If you don'tt code the nb parameters 
WIPEMOD uses the value of profile variable newbase as the 
name of the new bases If there's no such profile variable 
defineds WIPEMOD places the new base hack over the old 
base specified by the b parameter. 


un 3 

(optional) User Name in whose catalog the base specified 
by b/nb is to be founds if b/nb is not In the catalog of 
the current usere If you dontt code the un parameters 
WIPEMOD uses the value of profile variable baseown as the 
user name from whose catalog the base is to be obtaineds 
and if there's no such variable defineds WIPEMOD uses the 
current user's catalog. 


c or com or optic 3: 
{optional) tist of COMmon moduleis) to be deleted. 


r or reg or opl 3 
(optional) fist of REGuilar or QPL module{s) to be 
deteted,. 


flock or notock : 
these foptional) parameters determine whether the base 
update process is intertocked against simultaneous updates; 
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coding a filename for the tock parameter determines the 


name of the intertock file. Intertocking is the 
action when the base being updated is in another 


defauit 


userts 


catalog. If you don't code either of the tock or notock: 


keys» interlocking is controlied by the tokmode 
variable. Refer to the introductory sections 
chapter for information on the interactions of the 


profile 
of this 
fokmode 


profite variable and the tock and notock parameters. If 
you don't code a filename for the tock parameters the 


contents of profite variabie intriok is used 


as the 


interlock filename; if there's no such oprofile variables 
the name fintriok is used as the tock filename. The 
interlock file must be in the same catalog as the base 
being updated. If the interlock file cannot be founds the 


procedure aborts. 
batch job parameters : 
These parameters are described in section 1.7 


- "SES 


PROCEDURES RUN AS BATCH JOBS". The default for this 


procedure is to run in tocal modes but it can be run in 
batch mode. The dayfile parameter is not used by this 
procedures 

msg or nomsg : 
these f{ootional) keys control the generation of 


informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 


PROCEDURES". 


Example of WIPEMOD Usage 


sesewipemod mybase cz=(cdeckas cdeckb) r=(maine»astreets comd) 


DELETING MODULES FROM MYBASE 
NEW BASE ON SESTMPB 

NEW BASE NOW ON MYBASE 
SESTMPB PURGED 

END WIPEMOD MYBASE 


ettenh e + 


This example of WIPEMOD deletes common modules cdecka and 
from the base mybase. It also deletes regutar modules main 


cdeckb 
through 


street inclusives and regutar module comd. The exampie iitustrates 


the sort of informative messages output by WIPEMOD. 
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4012 XREEMOD. =. CROSS REFERENCE _OF_A_BASE 


XREFMOD produces across reference tisting of a basee. (XREFMOD 
is primarily intended as a “building block™ for other procedurese 
In particulars see the description of the LISTMOD procedure which 
runs XREFMDD as a batch job.) 


Qptionallys a single module (deck) name can be specified (for 
which are produced finstead of the normal output listing) a list of 
the reguiar modutes that reference (call) the module either directly 
or indirectiy (see the description of the m parameter for more 
information on this feature). 


In the normal (i.e. not the singte modute option) mode of 
outputs, xXREFMOD produces for each MODule {deck) the following 
information 3 


1. the name of the deck 

22 the date on which the deck was created 

3. the type of deck (see deck categories described below) 

4. the number of tines in the deck 

5- the position of the deck in the base 

6s a list of atl the decks that reference (cali) this deck 

7. a tist of atl the decks that are referenced (calted) by this 
deck 


Items 2 through 5 are replaced by a "flag" if the deck is 
"external" to the base being cross referenced. An external deck is 
one which is referenced (called) by one or more decks in the base 
but which is not itself contained in the base. A separate tJlist of 
all the external decks is produced following the main deck list. 


In items 6 and 7s a deck name may be preceded by 'I* indicating 
an Indirect references and/or by *** indicating an external deck. 


Ali deck tists are arranged in aitphabetical order. The page 
width and page tength are selectable via parameters. 
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Modules are categorized according to the following criteria : 


he eran cepa see SOS ARR END ENN MANNS HED ENR Seal AN “NS ete eee le AEN SAN ANE RE ED SS ND SEED A AD ND EDS END A ME STS OEE SEN SE NS ET ED ENO ND DS AD A OU SEED LENE SD ee ORD OD aD ae ND A i WN ND Ee ND eS VD De 


+ + + 
; : ; 
: ; 3 
ee cae te sn mee ne ee cee a ae sam ca se De eee + 
; ; ; 
: COMMON ; common deck ; 
a 3 a 
a a % 
sf se te ae ae ta en a se sn et np ene ee nae ee te a ee ee a ae ee A A ee a SS DM ae le ee ie en ste cae + 
; H H 
; MODULE $ first program fine is a MODULE tine ; 
3 : 3 
% 3 4 
> wee ww wee ewww ewe } we ee ee ee eee ee ee ee SA ON A EE AO A SAAN SE SE AS ONE ales SD TN RED A A He EN a ee + 
: ; ; 3 
H IDENT first program line is an IDENT tine H 
ci 2 e 
3 2 4 
pe ee ene ce oe ee ew a ae ne ee ee Ce ee ee + 
; ; H 
H PROGRAM. $ first program line is a PROGRAM tine ; 
2 2 I 
a a ; 
ee en ee ee ee ee me ce ee re ee ee a ae a ae ae ae en ae ee ee ee a ae ne a ae ee oe ee en a + 
H ; H 
; SESPROC $ first two characters of the first program tine i 
H { are *"\ %, that iss the SES processor master i 
H § contro! character followed by a spaces H 
: 3 s 
ee cee eee se cee em Me ee saon seme ee name ee ae ee ee cee eee a ee ce Se a ee ne ee a ee a ee Oe + 
H 4 4 
H TXTFORM + first character of the first line is a reverse 3} 
H $$ stant (\) : 
; H ; 
cer ee te en ee ee ‘Aa Cre -eniee Cink eae eae ste + AD AE GED en SN ND AE ED END CR CED AED ERD AD ED AERO A ARTA ED -SRED ND 0 SN ENS E AN EE -AEED -<AN DND OED D “  E 0 al EO CE ED th ED ED i a ee ee ei > 
H H ; 
; KCL $ first character of the first tine is an asterisk $ 
H + (*) and not immediatety followed by "CALL™s ¢ 
H $ "CALLC™s "IFCALL™s or "NIFCALL"™. H 
a 2 . 
3 4 2 
+ ee ee ee + ne ee ee Se ee + 
H H . ; 
: CCL $ first tine is a ePROC line H 
; H ; 
5 eeetond ee a a ae te SO Sie “aan etl iat Hem ame eee + ee eee + 
H H ; 
H UNKNOWN § (you guessed it) none of the above : 
. 2 ? 
2 % 4 
+ + + 
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* Up to five lines are examined if the first separator character 
of the previous tiinets) is a double quote {") or a question 
mark (2). 


Parameters to XREFMOD are :* 


bor ft 3 
(optional) name of Base Library for which the cross 
reference is to be generated. If you dontt code the 0b 
parameters, XREFMODD uses the value of profile variable base 
» and if there's no such variable defineds XREFMOD uses 
the defauit name of base, 


un 3 
(optionat) User Name in whose catalog the base specified 
by the b parameter is to be Found. If you don't code the 
un parameters XREFMOD uses the vatue of profile variable 
baseown as the user names and if there's no such variable 
defineds XREFMOD assumes that the base is in the current 
user's catatog. 


(optional) name of file to receive the Output from the 
cross reference rune If you dontt code the o parameters 
XREFMGD sends the output to File OUTPUT. 


moor mod 3 

(optional) name of a moduie (possibty externat) for which 
a fist of the reguiar modules that reference (call) it 
either directly or indirectly are produced. Each module 
name is written on a separate tine with a space in column 
l» the module name in columns 2 through 8 (left justifieds 
space filteds with tetters in upper case) and a period 
(~) in column 9. The module names are written in 
alphabetical order. 


pw oor pwidth : 
this (optional) parameter specifies the Page Width for the 
cross reference fisting. If you code this parameters you 
must give a vaiue of at feast 70. If you omit the pw 
parameters, XREFMOD uses a page width of 132. 
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pl or plength : 
this {optional) parameter specifies the Page Length for 
the cross reference tisting. If you code this parameters 
you must give a vatue of at feast 20. If you omit the pl 
parameters, XREFMOD uses a page Jength of 60. 
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4013 GETCOMN =~ ACQUIRE _CYBIL COMMON DECK LIBRARY 


GETCOMN: acquires the tatest SCU or MADIFY version of the CYBIL CC 
or CI common deck Jtibrary as a local file named either CYBCCMN of 
CYBICMN as is appropriate. Parameters to GETCOMN are 3: 


mad or scu 3 
these (optional) keys indicate which format of the CYBIL CC 
or CI common deck fibrary is desired. If you code the mad 
key» the MADIFY formatted version of the common deck 
library is made focal. If you code the scu key or do not 
code either of these keys» the SCU formatted version of the 
common deck library is made local. 


cc or ci: 
these (optional) keys indicate which version of the CYBIL 
common deck library is desired. If you code the ci keys the 
SCU or MADIFY formatted CYBIL CI common deck library is made 
focal. If you code the ce keys or code neither of these 
keys» the SCU or MADIFY formatted CYBIL CC common deck 
fibrary is made focal. 


You may also define PROFILE variabies to override the defautt 
file assignments for the various forms of the CYBIL common deck 
fibrary. For the CYBIL CC version the PROFILE variables should be : 


ccomn CYBCCMN in MADIFY format 
ccmnaun owner of teccmnt 

ccscu CYBCCMN in SCU format 
ecscun owner of *ccscu! 


For the CYBIL CI versions the PROFILE variables should be 3 


teomn CYBICMN in MADIFY format 
icmnaun owner of ticmn? 

icscu. CYBICMN in SCU format 
icscun owner of ticscu! 


Examopies of GETCGOMN Usage 
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sesegetcomn 
* SCU VERSION OF CYBCCMN MADE LOCAL 


sesegetcomn mad ci 
* MADIFY VERSION OF CYBICMN MADE LOCAL 


The first example shows GETCOMN acquiring the SCU version of 
CYBCCMN (both parameters take their defaults)s and the second 
example shows how to acquire the MADIFY version of CYBICMN. 


Note 3: please ensure that yoM RETURN the common deck Jibrary when 
you're finished with it. 
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5.0 LIBRARY _OR_MULTI_RBECORD_EILE_MANAGEMENI_USING LIBEDII 


SES supplies a comprehensive set of procedures to manage multi 
record files» using the NOS LIBEDIT utility as a basis. Itts 
assumed that you're fairly familiar with the ideas of multi record 
files and LIBEDITs otherwise SES can't realty provide a substitute 
for knowing what you're doing. The terminology that SES procedure 
descriptions of tibrary management use are as follows : 


LIBRARY A collection of records in a files Ait’ SES tibrary 
management procedures use an } parameter to refer to a 
Library. 


MEMBER A single record in a ftibrary files or a file containing a 
member which is added to or repiaced on aitibrary. Ait SES 
library management procedures use an m parameter to refer 
to MEMBER(S). 


GROUP a collection of member{s) that occupy one record per member 
on the file. 
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5.20 LIBRARY OR MULTI RECORD FILE MANAGEMENT USING LIBEDIT 


Summary Of Library Management Procedures 


GETMEM(S) 


REPMEM{S) 


REPULIB 


COLLECT 


CATLIB 


LISTMEM 


SORTMEM 


SRTULIB 


WIPEMEM 


WIPULIB 


LIBEOIT 


GET MEMberS gut of a tibrary anto a group file. The 
members appear one per togical record. 
REPtiace or add MEMberS on a =tibrary. You also use 


REPMEM(S) 


in a special way to create a brand new library 


from scratch. 


REPlace 


collect 


CATaliog 
members 


LIST MEMbers. 


members 


or add members ona User Library. 


a group of members onto a group file. 


a LIBrary to display the names and the types of 
in the tibrarys in short form output, 


LISTMEM generates 
librarys and optionally 


a catalog of all the 


on a prints every TEXT 


member from the library. 


SORT MEMbers 
that all 
Within each member type» 


The library is 
sane type 
members are 


arranged so 
appear together. 
sorted into 


in a tibrary. 
members of the 
the 


alphabetical order. 


SoRT members 


in a User LiBrary. 


WIPE (delete) MEMbers From a tibrary. 


WIPe (delete) members from a User LIiBrary. 


us2 the 


LIBEDIT utility directly. 
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Parameter Naming Convention for Library. Management 


This section introduces the parameter naming convention that's 
common to most of the procedures in the tibrary management system. 


{ or b name of Library on which the operations are to be 
performed. 


stands for Member(s). 


g or group mame of file upon which a GROUP of members are 
accumulated when adding ofr replacing members on a 
library» or when members are extracted from a 
library. A group file contains one member per togicat 
record. 


nfioor nb name of a New Library or New Bases used in those 
procedures that perform operations that permanently 
alter a$tibrarys requiring that a new tibrary be 
created. An explanation of the method used to update 
a library is contained in a subsequent section. 
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PROEILE Variables for Library Management 


The variables described below may be declared in your PROFILE in 
order to establish defauit information for the parameters of the 
library management procedures. 


tib name of library where members are to be found or repiaced,. 
tibown user name in whose catalog the library is to be found. 


newlib nane of new library for those procedures which update a 
librarys thereby creating a new onee The default name for 
newlib is the same name as the old tibrary. 


group used by ali procedures to designate a group files or a file 
containing one module per tlogical record. The default name 
for group is group. 


sestmp! used by all of the procedures that update tftibraries to 
specify the temporary library file during the update 
process. The default name for this file is sestmpl. 


fokmode determines the interlocking action when updating a 
library. The fokmode variable may be set to ‘'LOCK*® Ciock 
by default untess the notock parameter is coded on the 
procedure) or 'NOLOCK' (no tock by defauit unless the tock 
parameter is coded on the procedure), 


intrlok used by aif of the procedures that update tibraries or 
bases to specify the interlock file to be used during the 
update process. The default name for the interlock file is 
intriok. 


nx used by all of the procedures that update User LIBraries to 
specify whether a cross reference of entry points is to be 
inctuded in the library. If nx is set to any non-null 
values the entry point cross reference is got inciuded by 
defauits otherwise it is. 
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Libcary.Vpdating. Process 


Some of the tibrary management procedures physicality aiter a 
librarys requiring that a new library be created. The process is 
common to all such proceduress and is as follows : 


If you code both the t and nil parameterss new ftibrary is created 
simply by performing the required operations on the old tibrarys and 
writing the newly created ftibrary onto the file specified by the nf 
Parameter. 


If you code only the ( parameters update takes piace in two 
stages. The updating operation is performed and the new tibrary 
writen to a file called sestmpt (SES TeMPorary Library). sestmp! is 
then physicaliy copied back over the fite specified by the 1 
parameters and finaity sestmpl is purged. : 


Note that if the file specified by the nf (or 8 if nb is omitted) 
does not already exists a DIRECT access READ mode file is DEFINEd 
for the library (thiss of courses can onty be done if the owner of 
the fibrary is the current user). 


Note that if anything goes wrong during an updating runs the 
original library is atways teft intacts and only the new ftibrary or 
sestmpt is potentially incorrect. This means that you can recover 
by purging the new fibrary or sestmpl and starting the run agains 
If something goes wrong beface the tibrary appears on sestmpl> 
original ftibrary is intacts and sestmp! may be purgeds whereas if 
something goes wrong after the new library is on sestmpis that iss 
during the "rewrite" phase of the updates it is sestmp!i that is 
safes and the old tibrary that is wrong. In this cases you may use 
the REWRITE procedure to do the rewrite agains or alternativelys you 
may just oeurge the old tibrary and then change the name of sestmp! 
to be the Jibrary name. 
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Lotectock Process for _Uedating_a_Library 


When updating a Jibrary you can interlock the update so that only 
one user at a time can update the library. Those procedures that 
update a tlibrary are set up so that if the library to be updated is 
in another user's catalogs the tibrary is interlocked by default. 
You can override default actions by defining a tokmode variabte in 
your profiles or by coding a tock or nolock key on the procedures as 
shown in the diagram on the next page. 


Interlocking of a tibrary is done via an interlock file. Such a 
file must be a DIRECT access file in the same user's catalog as the 
libcacy being updated» Naturatly the interlock file must be a 
PUBLIC» WRITE MODE file if other users are likely to be using it. 
The default name used by the SES source code maintenance and tibrary 
management procedures for the lock file is interlok. You can have 
an interflock file of any name by defining the intriok profile 
variables or by coding a file name as a vaiue for the tock parameter 
on the appropriate procedures. 
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Gunec Qf Base 
Qc Library 


Aen cae aD an Oo ee ane a ae aD ie ee sane aie ee 


Action Laken H 


2p en ae ee ls a ee ee ee > Ga ie AD AD ne ee ep ES ee DO ee ES ee ee “ee ee ee ea 


+ Ames mate RD Cl te elle A thie hen ae a F cecemheensinentpmuntinmetenrienntonastantoanateandtentnanstaasatimeatonnteantean tena temeienstanatmont ai tentomteeten tia tomtenel SAND <A ND ES EN SE UE A OS NE EN ND a tn ss AD I A aE thin + 
‘ Coded Op : ; 
: Procedure : Action Taken H 
$e ee ee eee $n eee ee eee Oe a ee ee ee eee ee eee eee eee -+ 
; tock ; tibrary or base is locked ea sedine: of Swateate of 3 
H ; tokmode profile ver teore or cotner conditions. : 
$e a en em Sa a ew ee ee ee + 
; nolock ; tibrary or base is nat focked Mesah dies: of contents 3} 
H ; of tokmode pEorat® var labile or other Eons iy anss H 
$ eee ee meee Se a ne cee a ae oe tn eee oe  costectetetnteten a ae ee ne ae a ae oe a se ae + 
+ Nothing : faded io Profile :} Action Takeo H 
$ we oe ee $2 ee ee ee ee ee fe ee ee + 
; N lokmode=*LOCK® ; tibrary or base Ls focked 3} 
H >; unless overridden by nolock ; 
: $ parameter on PEOCeCUrSs ; 
| lealeaianteemeetetend - ee ee $ ee 2 ee ee + 
: NN. tekmode="*NOLOCK*?? library or base is not ‘oekea : 
; s; untess overridden by lock 
; H parameter on procecuves ; 
$e a wf ee ee Spe eh ee ne a ee ee -——+ 
3 
H 
+ 


fibrary or base is not 
locked untess the lokmode 
profile variabie is set 
to ‘fLOCK* or the tock 
parameter is coded on the 
procedure. 


Current User 


Se AD TU GEN RR SEND ED SRI ETS AED et aD inl atte tee 


Another User fibrary or base is Pecked 
untess the tokmode 
profile variable is set 
to *NOLOCK'® or the nolock 
parameter is coded on the 


procedure 


Oe oe SO Be 28 OS tp He Oe OO BH eae hh oe we bb 


AD lh DEIN AEE OR SD Wee een a tale eihie enim <a 
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Sel GETMEN_OR_ GETMEMS _=_EXTRACT MEMBER(S) FROM LIBRARY 


GETMEM(S) is intended for extracting any number of members from a 
library onto a group files with one member per logical recorde 
Parameters to GETMEM({(S) are 3: 


moor afl: 

if you code the ati keywords, GETMEM(S) extracts ALL 
members from the tibrary specified by the parameter. 
Otherwises you code the m parameter as a list of name(s) 
of Member(s) to be extracted. The list of member(s) must 
al! be of the same type (as specified by parameter 6). 
Ranges of member names may aiso be codeds as shown in the 
examples at the end of this description. 


g or group : 
(optional) name of group file to receive the member(s) 
extracted from the library. If you dontt code the g 
parameters GETMEM(S) uses the vaftue of profile variable 
groups and if there's no such variable defineds uses the 
name group for the group file. 


tor b 3 
{optional) name of Library from which the member{s) are to 
extracted. If you don't code the 1! parameters GETMEM(S) 
either uses the vatue of profile variable libs or if 
that's undefineds GETMEM(S) uses the name tib for the name 
of the library. 


un 
(optional) User Name in whose catatog the tibrary 
specified by f is to be founds if it isn't in the catalog 
of the current usere If you don't code the un parameters 
GETMEM(S) uses the vatue of profite variabie ftibowns and 
if there's no such variabte defineds the GETMEM(S) uses 
the user name of the current user. 


status or sts : 
status is an (optional) parameter used for those cases 
where GETMEM(S) is being used as a buitding block of more 
sophisticated procedures or jobs. The status parameter 
causes GETMEM(S) procedure to set one of the job control 
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registers to the vatue zero if GETMEM(S) successfully 
completeds, and non zero if anything went wrong during the 
run of GETMEM(S). The onty vatues that may be coded (for 
the status parameter are one of Rls R2»s R3 or EF. Any 
other value coded causes an error message to be outputs 
and GETMEM{S) procedure aborted. 


text or opt or optic or opid or rel or abs or ovi or pp or ppu or 

cos or ulib or cap or proc : 
these (optional) keys specifies the type of the members to 
be removed from the tibrary. If you dontt code any of 
these keys» GETMEM(S) assumes the members are of type 
TEXT. A description of the meanings of these rather funny 
looking keys can be found in the NOS Reference Manual 
under the description of LIBEDIT. 


Examples of GETMEM(S) Usage 


sesegetmem format Izsproctib un=Iir77 text 
* END GETMEM GROUP <= PROCLIB 


The exampte uses GETMEM to get one text member called format from 
a library calied proctib in the catalog of user tr77. 


sesegetmem (txtcodestxtformstxthead) binary tzprgtib unz=mv73 ovi 
* END GETMEM BINARY <= PRGLIB 


This example extracts a group of owl type records from a library 
called prgtib in the catalog of user mv73 and places them on a group 
fite called binary. 


sesegetmem (comput..piscans ciitev..ciiord) tzdbugtib ret 
* END GETMEM GROUP <= DBUGLIB 


This example illustrates how ranges may be coded for a 
parameter. The exampfe extracts all rel members comput through 
piscan inclusives and ali members ciifev through ciiord inclusives 
from a library called dbuglibs and places the extracted members aon 
the file called group. 
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Se2 REPMEM_IR_REPMEMS =_ADD_OR REPLACE MEMBER(S) _ ON LIBRARY 


REPMEM and REPMEMS are synonyms for a procedure to add new 
member(s) tos or replace member{s) on a library. Note * to add or 
replace members on a User LIBrarys for use by the CYBER loaders use 
the REPULIB procedure described below. Parameters to REPMEM{S5) 
are 3: ; 


m or mem or mems or member or members : 
{optional) list of Member(s) to be added to or replaced on 
the ftibrary. If you don*®t code the m parameters REPMEM(S) 
assumes that all the member(s) to be added or replaced are 
already on a file specified by the g parameter. 


g or group ? 
(optional) name of a group file on which member{s) are 
accumulated as one member per logical record. If you 
don't code the g parameters REPMEM(S) uses the value of 
profile variabie group. If there's no such profile 
variable defined» REPMEM(S) uses filename group as the 
group file. 


1 orb: 
{optionat) name of Library on which the member(s) are to 
be added or replaced. If you don*t code the 1: parameters 
REPMEM(S) uses the vatiue of profile variabie lib as the 
name of the library. If there's no such profile variablie 
defineds REPMEM(S) uses a Jibrary name of tib. 


nfipoor nb : 
(optional) name of New Library to be created when 
REPMEM(S) has completed its rune If you don't code the ni 
parameters REPMEM(S) uses the vatue of profile variable 
newlibs and if there's no such profite variable defineds 
REPMEM(S) writes the new library over the file specified 
by the parameter. 


un : 
(optional) User Name in whose catalog the library 
specified by  f/nt is to be founds if t/nl is not in the 
catalog of the current user. If you dontt code the un 
parameters, REPMEM(S) uses the value of profile variable 
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libown as the user name from whose catalog the library is 
to be obtaineds and if there's no such variable defineds 
REPMEM(S) uses the current user's catatog. 


flock or nolock : 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the interlock file. Intertocking is the defauit 
action when the base being updated ts in another user's 
catalog. If you don't code either of the tock or nolock 
keys» interlocking is controltied by the tokmode profiite 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the tock and nolock parameters. If 
you don't code a filename for the tock parameters the 
contents of oprofite variabte intriok is used asthe 
interlock filename; if there's no such profile variables 
the name intrtok is used as the tock filename. The 
interlock file must be in the same catalog as the base 
being updated. If the intertock file cannot be founds the 
procedure aborts.. 


batch job parameters : 
These parameters are described in section 127 - "SES 
PROCEDURES RUN AS BATCH JOBS". The defauit for this 
procedure is to run in tocal modes but it can be run in 
batch mode. The dayfite oarameter is not used by this 
procedure. 


rep or add or addrep or repadd : 
these (optional) keys specify whether youtre adding and 
reptacings or just replacing.» If you're only reptacing 
member(s)» you can code the rep key» If you omit this key 
afltogethers REPMEM(S) assumes that you're adding and 
replacing member(s) and = so issues the appropriate 
directives to LIBEDIT to perform that function. 


dir or bulld or nodir or nobuitd : 
these (optional) keys specify whether a directory is to be 
placed at the end of the fibrary when REPMEM(S) finishes 
tts rune Coding the dir or build options specifies that 
you want a directory record to be added to the Itbrarye 
If you code the nodir or nobuild optionss or if you dontt 
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code any of these keys» REPMEM(S) doesn#t adda directory 
but if a directory already exists it is updated. 


msg or nomsg ; 
these {optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 —- “INFORMATIVE MESSAGES FROM SES 
PROCEDURES", 


Examples of REPMEM(S) Usage 


seserepmem (firsts seconds third) izberkiibs build 
FIRST -> GROUP 

SECOND => GROUP 

THIRD -> GROUP 

REPLACING/ADDING MEMBERS ON BERKLIB 

LIBRARY NOW ON SESTMPL 

NEW LIBRARY NOW ON BERKLIB 

BERKLIB PURGED 

END REPMEM GROUP => BERKLIB 


+ eHht te eH 


This exampie ilfustrates REPMEM used to collect three members 
onto a group files and then place the contents of the group file on 
a fibrary called berktiib. The example shows some of the informative 
messages that appear during a REPMEM rune 


Creating_a.New Libracy with REPMEM(S) 


seserepmem lt=dummys nizproctibs g=newproc build 
* CREATING NEW LIBRARY PROCLIB 
* END REPMEM NEWPROC => PROCLIB 


This example illustrates how to build a new tibrary. The 1 
parameter is coded as some "dummy™ name that doesn't exist. The new 
members to be added are on a group file catted newproc. The new 
library is createds and a directory is added because of the build 
keye 
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903 REPULIB = ADD _OR_ REPLACE. MEMBER(S) ON USER LIBRARY 


REPULIB is a special version of REPMEM(S) to add or replace 
member(s) on a User LIBrary.»’ LIBEDIT (the basis for these tibrary 
management procedures) can't handie user tlibraries directly» so 
REPULIB uses the LIBEDIT and LIBGEN utilities to perform the process 
correctiy. Parameters to REPULIB are 3 


m™ or mem or mems or member or members ;: 
(optional) tist of Member(s) to be added to or reptaced on 
the library. If you don't code the m parameters», REPULIB 
assumes that all the member(s) to be added or reptaced are 
already on a file specified by the g parameter. 


g or group 3 
(optional) name of a group file on which member(s) are 
accumulated as one member per togical record. If you 
don't code the g parameters REPULIB uses the vaiue of 


profile variabie group. If therets no such profile 
variable defineds REPULIB uses filename group as the group 
file. 

f or b: 


(optional) name of Library on which the member(s) are to 
be added or replaced. If you don't code the 1 parameters 
REPULIB uses the vaiue of profile variable lib as the name 
of the tibrary. If there's no such profile variabte 
defineds REPULIB uses a tibrary name of tib. 


nioor nb : 
(optional) name of New Library to be created when REPULIB 
has completed its rune If you don't code the ni 
parameter, REPULIB uses the vatue of profile variabte 
newlibs, and if there's no such profile variable defineds 
REPULIB writes the new library over the file specified by 
the #§ parameter, 


un 3 
{optionali) User Name in whose cataiog the fibrary 
specified by t/nt is to be founds if i/nt is not in the 
catalog of the current user. If you don'ft code the un 
parameters REPULIB uses the vatue of profile variable 
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5-0 LIBRARY OR MULTI RECGRD FILE MANAGEMENT USING LIBEDIT 
5.3 REPULIB - ADD OR REPLACE MEMBER(S) ON USER LIBRARY 


libown as the user name from whose catalog the library is 
to be obtaineds and if there*s no such variable defineds 
REPULIB uses the current user's catalog. 


flock or nolock :; 


these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates} 
coding a filename for the tock parameter determines the 
name of the interlock file. Interlocking ts the default 
action when the base being updated is in another user's 
catalog. If you dontt code either of the flock or notock 
keys» interlocking is controtied by the tlokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the fock and nolock parameters. If 
you don't code a filename for the tock parameters the 
contents of oprofile variable intriok is used as the 
interlock filename; if there's no such profile variables 
the name intrliok is used as the lock Filename. The 
interlock file must be in the same catalog as the base 
being updated. If the intertock file cannot be founds the 
procedure aborts. 


batch job parameters ;: 


These parameters are described in section 1.7 - “SES 
PROCEDURES RUN AS BATCH J0OBS®. The defauit for this 
procedure is to run in Focal modes but it can be run in 
batch mode. The dayfilte parameter is not used by this 
procedure, 


rep or add or addrep or repadd : 


nx 


this Coptional) key specifies whether you're adding and 
repiacings or just replacing. If you're goniy reptacing 
member(s) you can code the rep keye If you omit this key 
altogether» REPULIB assumes that you're adding and 
replacing member(s) and so issues the appropriate 
directives to LIBEDIT to perform that function. 


this (optional) key indicates that when REPULIB performs 
the LIBGEN portion of its jobs that LIBGEN should not 
buiitd a cross reference of entry points in the ULIB 
recorde You can set your own default for this parameter 
by defining the nx variabte in your profile (any non-null 
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value causes the cross reference to not be built). Refer 
to the LIBGEN documentation in the NOS reference manual. 


mSQ or nomsg : 
these {optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - “INFORMATIVE MESSAGES FROM SES 
PROCEDURES"™. 
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Se COLLECT =_ COLLECT MEMBER(S). TO_BUILD_A_GROUP_EILE 


COLLECT is used in conjunction with tibrary management procedures 
such as REPMEM(S). COLLECT is used to accumulate members onto a 
group file for subsequent processing by REPMEM(S)» LIBEDIT and so 
one COLLECT can also be used in conjunction with source text 
maintenance proceduress to collect text moduless adding headers and 
COMMON fines if required. Parameters to COLLECT are 3: 


m or mem ofr mems or member or members ? 
(optional) fist of Members to be accumulated onto the 
group file. Note : if the file specified by the om 
parameter is a multi record files COLLECT dges gather all 
records in the file. This capability is not available 
with the c andr parameters as it is not truly appticabie 
in those cases. 


c or com or optc : 
(optional) tist of COMmon modules to be accumulated onto 
the group file. COLLECT assumes that such modules are 
straight text filess and so COLLECT places the module name 
and COMMON tine at the start of the module. 


r or reg or opt : 
(optional) fist of REGular moduftes to be accumulated onto 
the group file. COLLECT assumes that such modules are 
straight text Fiies»s» and so COLLECT places the module name 
at the start of the module. 


g or group : 
(optional) name of group file onto which the member(s) or 
module({(s) are to be accumulated. If you don't code the g 
parameters COLLECT uses the vaiue of profile variable 
group. If there's no such variable defined in your 
profiles COLLECT uses the filename group. 


msg or nomsg : 
these {optional) keys contro! the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - “INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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Example of COLLECT Usage 


sesecoltiect (docodesdostatseatupselseifsequal) g=coders 
DBOCODE —> CODERS 

DOSTAT -> CODERS 

EATUP -> CODERS 

ELSEIF => CODERS 

EQUAL -> CODERS 

END COLLECT CODERS 


ttt & He 


This example of COLLECT illustrates how it is used to accumulate 
a bunch of records onto a group file. 
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5e5 CATILIB.=_PRODUCE _LIST_OF_ MEMBERS _IN_A_LIBBARY 


CATLIB is used to display a tist of the members in a tibrary. 
CATLIB outputs the members tist in a condensed formats four members 
per tines showing onty the member names and their type. Parameters 
to CATLIB are 3 


tor b 3. 
{optionait) name of Library which is to have its member 
names displayed. If you don't code the t parameters 
CATLIB uses the value of profile variable tib as the name 
of the fibrarys and if there's no such variable defineds 
CATLIB uses a File name of tib. 


un 3 
(optional) User Name in whose catalog the library 
specified by the ! parameter is to be found. If you dontt 
code the un parameters CATLIB uses the value of profite 
variable tibown as the user names and if there's no such 
variable defined» CATLIB uses the current user's catalog. 
0 3 


{optionat) name of file to receive the OQutput from 
CATLIB. If you don*t code the o parameters CATLIB places 
the member tist on file output. 


short or tong : 
these (optional) keys determine the format of the output 
from CATLIB. If you omit this poarameter or code the short 
keys CATLIB produces its output in the form shown in the 
example below. If you code the tong key» CATLIB produces 
its output in the same format as the NOS utility CATALOG. 
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sesecatiib b=csiolib un=my69 
CSIOLIB.ULIB AG3ZTOIA. eREL AGSTOIAS eREL CATLIST.eREL 
CNVCASE.-REL CPYAceeeeREL CO3TOIAs’ eREL ITATOA63. REL 
IATOA64%. REL TATON63.eREL TATON64. eREL IDEBUGee REL 
IDEBUGI.-«REL IKMISCoeeREL ISCLMSG.eREL ISWLSYS.eREL 
ISYSTIM.eREL MCOMPo22eREL MCS cece a eREL MCSCNVeeeREL 
MEXPReeeeREL MGET eee eeREL MGETCSP.eREL MGETKCSeeREL 
MGETS YM. eREL MGETTOK.eREL MLOCFIL.~-REL MMSGeeeeeREL 
MPDTPVT.eREL MPLISTe2eREL MPUTe eee eREL MSTREAM.eREL 
MTOKCNV.eREL N6O3TOIAs’» REL NO&TOTAs eREL PKUNPKeeeREL 
ZIATOXCeeREL ZXCTOIA. REL CSIOLIB.»-OPLD 


* END CATLIB DUSLIB 
This example shows CATLIB output for a tibrary csiotib in the 


cataiog of user mv69. The member types are as defined in the NOS 
reference manual section on LIBEDIT. 
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506 LISTMEM =_LIST CONTENTS _QE_ LIBRARY 


LISTMEM performs two main functions to show you what's in a 
fibrarys and to get a printout of the TEXT members in the library if 
necessary. LISTMEM first generates a normal CATALOG which shows the 
names of all the members in the ftibrary. Lastiys LISTMEM generates 
a printout of afi TEXT members in the tibrary - you can suppress 
this if you onty want the catalog without the whole library's 
contents. Parameters to LISTMEM are 3; 


f or b 3 
(optional) name of Library to be processed. If you don*t 
code the b parameters LISTMEM uses the vatiue of profile 
variable tib as the library names and if there's no such 
variable defineds the LISTMEM uses the default name lib. 


0 3 
{optional) name of File to receive the Qutput from LISTMEM 
places the output on some unique file name that it 
generates. The output doesn't defauitt to file output 
becauses if you're running LISTMEM interactivelys you 
probably don't want the rather voluminous output on the 
screene 

un 3 
(optional) User Name in whose catalog the tibrary 


specified by § is to be found. If you don't code the wun 
parameters LISTMEM uses the value of the vaiue of profile 
variable ftibowns and if there isn't such variabte defineds 
LISTMEM uses the user name of the current user. 


batch job parameters : 
These parameters are described in section 127 ~- "SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in batch modes but it can be run in 
focal mode. The dayfile parameter is not used by this 
procedure. 


print 3 
this (optional) parameter indicates how the output of 
LISTMEM is to be printed. For the print parameter you may 
code any of the parameters to procedure PRINT. If you 
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don't code the print parameter at atts LISTMEM prints one 
(1) copy of the output on the ASCII printer. 


short : 
if you code this (optional) keys LISTMEM only generates 
the catalog outputs and suppresses the listing of alti’ the 
TEXT members. 


Examples of LISTMEM Usage 


seselistmem print=c23 short 
122342562 SUBMIT COMPLETE. JOBNAME IS ACULARS 
* JOB LISTMEM SUBMITTED 


This exampte shows LISTMEM used to process a fibrarys shatever 
name is the value of ftib. Three copies of the short Jlist (catalog 
only) are being produced. LISTMEM is being run in batchs rather 
than interactively. 


sesetistmem b=proctib ozprocs printz=(cz=2sh=*latest/proctib®) 
18.12.00. SUBMIT COMPLETE. JOBNAME IS ANAPABS 
* JO8 LISTMEM SUBMITTED 


This example shows LISTMEM being run in batch to produce two full 


printouts of the catalog and all the TEXT members in the tibrary 
proctib. The title on the listing is ttatest proctib'. 
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Je? SORTMEN _=_30RT_LIBRARY _INTO_ALPHABETICAL ORDER 


SORTMEM rearranges a tibrary such that all the members of a given 
type appear in the ftibrary togethers and within each types the 
members are sorted into alphabetical order. Note 2? to sort a User 
LiBrarys for use by the CYBER toaders use the SRTULIB procedure 
described below. Parameters to SORTMEM are 3: 


for b 3 
{optionat) name of Library to be sorted. If you don'tt 
code the ! parameters SORTMEM uses the value of profile 
variable fib. If there*s no such profile variabie 
defineds SORTMEM uses the name Jib. 


nivor nb : 
{optional) name of New Library to be created at the end of 
the SORTMEM run. If you dontt code the nit parameters 
SORTMEM uses the value of profile variable newlib. If 
there's no such profile variabte defineds SORTMEM writes 
the new tibrary on the file specified by the 1 parameter. 


un 3 

{optionali) User Name in whose catalog the library 
specified by t/nt is to be founds if t/ni is not in the 
catalog of the current user. If you don't code the un 
parameters SORTMEM uses the vatue of profite variable 
tibown as the user name from whose catalog the library Is 
to be obtaineds and if there's no such variable defineds 
SGRTMEM uses the current user's catalogs 


(optional) name of file to receive the Output of the 
programs used to run SORTMEM. If you don't code the o 
parameters, SORTMEM sets 070s or no output. This ts 
usually the desirable default» since the sort process 
generates ftarge votumes of output. 


edtsort : 
{optional) pair of filenames representing the input = and 
output files of the EDT text editor. You can use edtsort 
to EDIT the SORT output to impose your own ordering on the 
members in the Jibrary. 
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flock or notock : 
these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the fock parameter determines the 
name of the intertock file. Interlocking is the defauit 
action when the base being updated is in another user's 
catalog. If you don't code either of the fock or notock 
keys» intertocking is controlted by the ftokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variabie and the fock and noltlock parameters. If 
you dontt code a filename for the lock parameters the 
contents of profile variable intriok Is used as the 
interlock filename; if there’s no such profile variables 
the name intriok is used as the lock filename. The 
interlock file must be in the same catalog as the base 
being updated. If the interlock File cannot be founds the 
procedure aborts. 


batch job parameters : 
These oarameters are described in section 1.7 - "SES 
PROCEDURES RUN AS BATCH J0BS*. The default for this 
procedure is to run in focal modes but it can be run in 
batch mode. The dayfile parameter is not used by this 
procedure. 


nodir or nobuif'd or dir or build ; 

these (optional) keys indicate whether a directory is to 
be placed at the end of the tibrary when SORTMEM has 
finished its rune If you code the nodir or nobuild keys 
SQRTMEM doesnitt ptace a directory in the library. If you 
code the dir or build key» SORTMEM does piace a directory 
in the ltibrary. If you don't code any of these keyS» 
SORTMEM does a builds that is» a directory is created for 
the sorted library. 


msg or nomsg : 
these (optional) keys control the generation ‘of 
informative messages by this procedure and are fully 
described in section 1.28 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES™,. 
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Examptes of SORTMEM Usage 


sesesortmem tz=proctib batchn 
17252200. SUBMIT COMPLETE. JOBMAME IS ADXIBEN 
* JOB SORTMEM SUBMITTED 


This example ittustrates SOQRTMEM being run as a batch job by 
coding the batch key» SORTMEM is being used to sort the file 
proctib into order. 


sesesortmem tzberklib tock build 
LOCKING BERKLIB VIA INTRLOK 
BERKLIB LOCKED 

GENERATING MEMBER LISTS FOR BERKLIB 
SORTING MEMBER LISTS 

EXTRACTING MEMBERS FROM BERKLIB 
SORTING BERKLIB ONTO SESTMPL 
NEW LIBRARY ON SESTMPL 

NEW LIBRARY NOW ON BERKLIB 
SESTMPL PURGED 

BERKLIB UNLOCKED 

END SORTMEM BERKLIB 


HHH HH ee 


This example iltustrates SORTMEM run while you waits at the 
terminat. The exampte shows the informative messages output by 
SORTMEM during its run. 
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5e8 SRIULIB_=_SORT_USER LIBRARY INTO ALPHABETICAL ORDER 


SRTULIB is a special version of SOQRTMEM for sorting a User 
LIBrary into alphabetical order. LIBEDIT {the basis for these 
tibrary management procedures) can't thand$e user libraries directiy» 
so SRTULIB uses the LIBEDIT and LIBGEN utilities to perform the 
process correctly. Parameters to SRTULIB are : 


f or bt 
(optional) name of Library to be sorted. If you dont 
code the # parameters SRTULIB uses the vatue of profile 
variable fib. If there's no such profile variable 
defineds SRTULIB uses the name tib. 


nipoor nb 2. 
{optional) name of New Library to be created at the end of 
the SRTULIB- run. If you dontt code the ni parameters 
SRTULI8B uses the vaiue of profite variabie newlib. If 
there's no such profile variable defineds SRTULIB writes 
the new library on the file specified by the ! parameter. 


un. 3 

{optional) User Name in whose catalog the library 
specified by i/nt is to be founds if t/ni is not in the 
catalog of the current user. If you don't code the un 
parameters SRTULIB jouses the value of profile variable 
fibown as the user name from whose cataiog the library is 
to be obtaineds and if there's no such variable defineds 
SRTULIB uses the current user's catalogs 


(optional) name of file to receive the Output of the 
programs used to run SRTULIB. If you don't code the o 
-parameters SRTULIB sets 020s or no output. This is 
usualty the desirable defaults since the sort process 
generates ftarge volumes of output. 


edtsort ;: 
(optional) pair of fllenames representing the input = and 
output files of the EDT text editor. You can use edtsort 
to EDIT the SORT output to impose your own ordering on the 
members in the library. 
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lock or nolock : 


these (optional) parameters determine whether the base 
update process is intertocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the interlock file. Interlocking is the default 
action when the base being updated is in another user's 
catalog. If you don't code either of the tock or  nolock 
keys» interlocking is controtied by the tokmode profile 
variabie. Refer to the introductory sections of this 
chapter for information on the interactions of the fiokmode 
profile variable and the fock and notock parameters. If 
you don't code a filename for the flock parameters the 
contents of profile variable intriok is used as _ the 
intertock filename; if therets no such profile variables 
the name intrtok is used as the fock filename. The 
interfock file myst be in the same catalog as the base 
being updated. If the interlock file cannot be founds the 
procedure aborts. 


batch job parameters : 


nx 


These parameters are described in section 1.47 - "SES 
PROCEDURES RUN AS BATCH JOBS*. The defauit for this 
procedure fis to run in local modes but it can be run in 
batch mode. The dayfile parameter is not used by this 
procedure. 


this (optional) key indicates that when SRTULIB performs 
the LIBGEN portion of its jobs, that LIBGEN should not 

build a cross reference of entry points in the ULIB 
record. You can set your own default for this parameter 
by defining the nx variable in your profiite (any non-null 
value causes the cross reference to not be bullt). Refer 
to the LIBGEN documentation in the NOS reference manual. 


msg or nomsg ; 


these (optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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5°9 WIPEMEM_=_DELETE MEMBER(S) EROM_ LIBRARY 


WIPEMEM is intended as a means of deleting member{s) from a 
library. Note : to detete member(s) from a User LIBrarys for use 
by the CYBER toaders use the WIPULIB procedure described below. 
Parameters to WIPEMEM are : 


for b 3 
(optional) name of Library from which member(s) are to be 
deleted. If you don*t code the ! parameters, WIPEMEM uses 
the value of profile variabie tib as the name of the 
fibrary. If there's no such profile variable defined, 
WIPEMEM uses the name fib as the name of the library. 


nipor nb ? 
(optional) name of New Library to be created at the end of 
the WIPEMEM run. If you don't code the nl parameters 
WIPEMEM uses the vatue of profile variable newlib as the 
name of the new tibrarye If there's no such profile 
variable defineds WIPEMEM places the new Library back over 
the ofd tibrary specified by the i parameter. 


un : 
(optional) User Name in whose catatoq the tibrary 
specified by t/ni is to be founds if i/nt is not in the 
catalog of the current usere If you don't code the wn 
parameters WIPEMEM uses the value of profile variabie 
fibown as the user name from whose catatog the ftibrary is 
to be obtaineds and if there's no such variable defineds 
WIPEMEM uses the current user's catalog. 


text 3 
(optional) fist of TEXT member(s) to be deleted. 


optic or com or c ?: 
(optional) fist of OPLC Common member(s) or COMmon modules 
to be deiteted. 


op! or reg or fr 3 
{oetional) fist of OPL or REGular member{s) to be 
deteted. 
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rel: 


ovi : 


abs : 


ppu : 


cos ; 


oe 


cap 


{optional) fist of  RELocatable binary member{s) to be 
deleted. 


{optional) tist of OVerlLay type member(s) to be deleted. 


{optional) tist of ABSoltute type member(s) to be deleted. 


{ootional) list of PPU type memberi{s) to be deleted. 


foptional) list of PP type member(s) to be deleted. 


(optional) Jist of COS type member(s) to be deleted. 


{optional) tist of CAP type member(s) to be deleted. 


(optional) fist of CCL (not SES) PROCedure member(s) to be 
deleted. 


flock or nolock 3: 


these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates}; 
coding a filename for the fock parameter determines the 
name of the interlock file. Intertocking is the defauit 
action when the base being updated is in another user'ts 
catalog. If you don*t code either of the tock or =nolock 
keys» interlocking ts controttied by the ltokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the tock and nolock parameters. If 
you don’t code aé fitename for the tock parameters the 
contents of profile variable intriok is used as the 
interlock filename; if therets no such profile variabtes 
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the name intriok is used as the tock filename. The 
interlock file must be in the same catalog as the base 
being updated. If the intertock file cannot be founds the 
procedure aborts. 


batch job parameters : 


These parameters are described in section 147 - "SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in local nodes but it can be run in 
batch mode. The dayfile parameter is not used by this 
procedure. 


msg or nomsg ;: 


these Coptional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - “INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 


Example of WIPEMEM Usage 


sesevipemem t=thislibs text=(heavysusers)s relziasteeaccess 


+ enenhe & 


This 


DELETING MEMBERS FROM THISLIB 
NEW LIBRARY ON SESTMPL 

NEW LIBRARY NOW ON THISLIB 
SESTMPL PURGED 

END WIPEMEM THISLIB 


example of WIPEMEM illustrates the way in which multipie 


fists of record types may be codeds and also shows a range of record 
types coded for the rel type. 
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3010 WIPULIB_=_DELETE MEMBER(S) FROM USER LIBRARY 


WIPULIB is a special version of WIPEMEM for deleting (wiping) 
member(s) from a User LIBrary. CLIBEDIT (the basis for these fibrary 
management procedures) can't handie user Jibraries directly» so 
WIPULIB uses the LIBEDIT and LIBGEN utilities to perform the process 
correctiy. Parameters to WIPULIB are 3: 


f or b 3 
{optional) name of Library from which member(s) are to be 
deteted. If you don't code the { parameters WIPULIB uses 
the value of profile variable tib as the name of the 
library. If there's no such profile variable defined» 
WIPULIB uses the name tib as the name of the library. 


ni or nab 3 
{optional) name of New Library to be created at the end of 
the WIPULIB run. If you don't code the ni parameters 
WIPULIB uses the value of profile variable newlib as the 
name of the new tibrary. If therets no such. profile 
variable defineds WIPULIB places the new fibrary back over 
the old tibrary specified by the t parameter. 


un 3 

(optional) User Name in whose catalog the library 
specified by ItI/nl is to be fFounds if t/nt ts not in the 
catalog of the current user.» If you don't code the un 
parameters WIPULIB uses the vatue of profile variable 
fibown as the user name from whose catatog the fibrary is 
to be obtaineds and if there's no such variable defined» 
WIPULIB uses the current user's catalog. 


mem or m or rel 3 
fist of member(s) to be deleted. 


flock or nolock 3: 
these (optional) parameters determine whether the base 
update process is intertocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the Interlock File. Intertocking is the default 
action when the base being updated is in another user's 
catalog. If you don't code either of the tock or nolock 
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keyse interlocking is controlfted by the tlokmode profile 
variable. Refer to the jintroductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the tock and notock parameters. If 
you don't code a filename for the tock parameters the 
contents of profile variable intrtok is used as the 
interftock filename; if there's no such profile variables 
the name intrtok is used as the fock filename. The 
interlock file must be in the same catalog as the base 
being updated. If the interlock file cannot be founds the 
procedure aborts. 


batch job parameters ; 
These parameters are described in section 127 - "SES 
PROCEDURES RUN AS BATCH J085". The default for this 
procedure is to run in tocal modes but it can be run in 
batch node. The dayfite parameter is not used by this 
procedures 


nx 3 

this (optional) key indicates that when WIPULIB performs 
the LIBGEN portion of its jobs that LIBGEN should not 
build across reference of entry points in the ULIB 
record. You can set your own default for this parameter 
by defining the nx variable in your profile Cany non-null! 
value causes the cross reference to got be built). Refer 
to the LIBGEN documentation in the NOS reference manual. 


msg or nomsg : 
these (loptional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES", 
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5ell LIBEDIT =_RUN_LIBEDIT UTILITY 


LIBEDIT is intended as a means of calling NOS LIBEDIT utility 
directiy. Although SES library management procedures use the 
LIBEDIT utitity themseivess not att the functions of LIBEDIT are 
availables since SES procedures are oriented towards the most common 
functions. The LIBEDIT procedure gives you direct control over the 
LIBEDIT utility» but still provides ail SES convenience of ATTACHing 
your Ffites for you and so one Parameters to LIBEDIT are 3; 


g or group or tIgo : . 
(optional) name of File containing recordis) to be 
inserted or replaced on the library specified by tf. If 
you dontt code the g parameters LIBEDIT uses the value of 
profile variable groups and if there's no such variable 
defineds uses the default filename group. 


tf or b : 
(optional) name of the old Library to be manipulated by 
LIBEDIT.~ If you don't code the § parameters LIBEDIT uses 
the value of profile variable tib as the name of the 
librarys and if there's no such variable defineds LIBEDIT 
uses the default name of tib. 


nfiioor nb 3: 
(optional) name of the New Library after the LIBEDIT run. 
If you dontt code the nil parameters LIBEDIT uses the value 
of profile variabte newlibs and if there*s no such 
variable defineds the LIBEDIT writes the new library back 
on top of the library specified by ¢. 


{optional) User Name in whose catalog the tibrary 
specified by i/nt is to be founds if i/nt is not in the 
catalog of the current user. If you don?t code the un 
parameters LIBEDIT uses the value of profile variable 
fibown as the user name from whose catalog the ftibrary its 
to be obtaineds and if there's no such variable defineds 
LIBEDIT uses the current user's catalog. 


{optionai) fist of character strings which represent 
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LIBEDIT utility directives. Using the i parameters it is 
possible to perform many LIBEDIT operations using a singte 
control statement. If you don't code the & parameters 
LIBEDIT assumes the directives are coming from file 
INPUT. If you code the # parameter as a single name» 
LIBEDIT assumes that it's the name of a file containing 
LIBEDIT directives. 


this (optionat) parameter specifies the name of the file 
to receive the listing output from LIBEDIT. If you dontt 
code this parameters LIBEDIT piaces its listing output on 
File QGUTPUT. 


flock or nolock : 


these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the interlock file. Interlocking Is the default 
action when the base being updated is in another user's 
catalog. If you dontt code either of the tock or nolock 
Kkeyss interlocking is controlied by the ltlokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profite variable and the tock and notock parameters. If 
you dontt code ae filename for the tock parameters the 


contents of profile variable intriok is used as the _ 


interlock filename; if there's no such profile variabies 
the name intrlok is used as the tock filename. The 
interlock file must be in the same catalog as the base 
being updated. If the interlock file cannot be Founds the 
procedure aborts. 


msg or nomsg : 


these {optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES", 


COMPANY PRIVATE 


5-34 
CDC —- SOFTWARE ENGINEERING SERVICES 
7/30/81 
Pe m SES (Release 17) User's Handbook REV: AB 
5.0 LIBRARY OR MULTI RECORD FILE MANAGEMENT USING LIBEDIT 
5e11l LIBEDIT - RUN LIBEDIT UTILITY 


PO OG RE OE PE HE PE PE PE OE OO PE PE PE PE RO OE PEE BO F820 BO OE OF PE PE 8 FO PO AE 8 8 88 FE O88 PO POPE OE PO OE OE PE OE PE 8 PE PG PEPE ON PE 90 FE PE OE HE PE PO PO PE 8 10 88 FE TO 


Exampte of LIBEDIT Usage 


seselibedit tzprogtib iz'*isovi/catalogscatlistssesmsg? 
eeoee here appears the output from LIBEDIT utility 
NEW LIBRARY ON SESTMPL 
NEW LIBRARY NOW ON PROGLIB 
SESTMPL PURGED 
END LIBEDIT PROGLIB 


ett + 


The examp!e itlustrates how the LIBEDIT utitity inout directive 
may be coded as a string parameter on the procedure call line. The 
text preceded by periods indicates wheres in the actual use of 
LIBEDITs output from the LIBEDIT utitity itself appears. 
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6.0 GETTING INEQRMATION 


This chapter describes a collection of SES procedures to find out 
what's going on and what's avaifabite. There are two main areas of 
interest : 


le. Information about your tocal environment on NOS - what files 
you haves your validation tlimitss the times parts of your 
dayfiles and others. 

2e Information about SES - documentss procedures and status. 


CATLIST display comprehensive information about files in a user's 
catalog. 


CATALOG gives a condensed tist of the records in a library. 


PERMIT gives permission information for fites in a useris 
catalog. 


FILES display information about local files. 


TOOLDOC prints documents describing tools 


TOOLREP displays status and problems for a specified tool or 
product. 


INFO displays the tatest information about SES. 


uUSSDOC gets User Supplied Software document. 


USSINFOQ displays the tatest information about User Supplied 
Software. 
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DAYFILE 


LIMITS 


DISPLAY 


TIME 


DAYWEEK 


SESPROC 


SESPARMS 


dispiays a sefected part of your dayfile. 

displays your LIMITS information in a condensed format. 
displays various information about your job environment 
“talks” the current time as a dayfile message. 


tells you what day of the week a date fell ons fFalis on 
{that is» today)» or will fall on. 


generates a fist of names of SES procedures. 


generates a printout of the parameter tists of SES 
procedures in any selected procedure fibrary. 
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6e1 CATILIST =_DISPLAY PERMANENT _EILE_INFOQRMATION © 


CATLIST gives you a concise but very comprehensive list of 
information about all files in a catalog. The files are tisted in 
alphabetical orders three files per tines so that you can get 45 
Files worth of information on one screentoad. The worid goes by 
your window more slowly» so to speak, For each fite in the 
specified catalogs CATLIST outputs the information in the following 
format : 


FILENAM type category mode ftength 


where the different things displayed are 3 


FILENAM is of course the name of file in question. 


type is the access type for the file. It is I for an Indirect 
files and D for a Direct file. 


category is the security of the fiie. This field is PU for a PUb!lic 
files SP for a Semi Private files and PR for a PRivate 
file. 


mode is the access mode for the file. This is one of R_ for 
Reads Wifor Writes M for Modifys A for Appends RM for Read 
Modifys and RA for Read Append and E for Execute. 

length is the tength of the file in PRUS. 


For examples ae typical fine of output from CATLIST would be 
fike : 


MAILBOX I PU RA ool MAXBIN D PU R 342 PROFILE I PR R eel 


This tine of CATLIST output shows that MAILBOX is an Indirect 
access PUbtic Read Append mode file of 1 prus MAXBIN is a Direct 
access PUblic Read mode fite of 342 prus»s and PROFILE is an Indirect 
access PRivate Read mode File of 1 pru. 
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Parameters to CATLIST are ? 


un : 


fpi 3 


Nate 


2 
a 


(optional) User Name of the (alternate) catalog to be 
CATLISTed. If you don't code the un parameters the 
current user's catalog is CATLISTed. 


{optional) Pack Name for files to be CATLISTed. tf you 
don't code the pn parameters the files on the default pack 
are CATLISTed. 


(optional) name of file to receive the OQutput from 
CATLIST. If you don't code the o parameters, CATLIST uses 
File output. 


this (optional) parameter is used to tet! CATLIST how many 
file descriptions it should write on each tine of the 
output file. If specifieds the Files Per Line parameter 
must be given a numeric value from 1 to 10. If you donft 
code the fpi parameters CATLIST generates 3 files per 
lines 


CATLIST can onty handle the first thousand files in a 


userts catalog. 


Exampie of CATLIST Usage 


The example below shows a CATLIST for another user's catalog. 


sesecatiist un=is69 
CATLIST OF LS69 FOR LR78 { 13 FILES» 10769 PRUS ) 


CSIOLIB 
DOC BASE 
DO2S64. 
MAILBOX 
UTILITY 
* END 


D 
D 
D 
I 
D 
Cc 


SP R 2167 CSTOPL. D SP R 2585 DICTION I SP R 2125 
SP R 1158 DOLPLO64 D SP R 0255 DO2ZR64—e D SP R 4347 
SP R .783 INTRLOK D PU R «e209 ISWLLIB I SP R «237 
SP W 0006 PROCLIB D SP R 2.409 PROGLIB D SP R 6126 
SPR .971 
ATLIST 
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602 DAYEILE =-_DISPLAY_ SELECTED PORTIONS OE _DAYEILE 


DAYFILE displays either the fast 14 lines of your dayfile»s, or to 
display any number of fines starting at a specified character 
stringe Parameters to DAYFILE are 3: 


nor tist : 
{optional) number of tines of dayfile to dispiay. If you 
don't code the n parameters, DAYFILE dispiays 14 tines. 


find 3: 
(optional) character string at which to start displaying 
the dayfile. If you don't code the find parameters 
DAYFILE always goes to the fine specified by tast _line-n. 
If you code a character string for this parameters DAYFILE 
goes to the fast occurrence of that character strings then 
dispiays n tines starting from tnat string. 


o or output 2. 
{optional) name of file to receive the output from 
DAYFILE. If you don't code the o parameters DAYFILE uses 
file output. 


Note : If you code the find parameters the ? character may not be 
a part of the character string» as ? is used as the string 
delimiter for the search. 
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603 CATALOG =_SHOW LIST DE_RECORDS_IN_A_EILE 


CATALOG performs the NOS CATALGG operation on a file. The NOS 
CATALOGS utility outputs a targe amount of information about the 
recordss most of which is never used. The SES CATALOG procedure 
outputs a condensed form of the information. from CATALOGs showing 
only the record names and their types. CATALOG outputs its 
information in the form 3 


RECNAME TYPE RECNAME TYPE RECNAME TYPE RECNAME TYPE 


four record names and their types are dispiayed on one tines so that 
if you're using a (713) g-kterminals the names and types of sixty 
records can be displayed before the information goes off the top of 
the screens The world goes by your window more siowlys so to 
speak. Parameters to CATALOG are ?: 


for b?: 
name of Library or Base whose contents are to be 
CATALOGED. CATALOG is so arranged that if the file to be 
CATALOGGed is local to your running job at the time the 
CATALOG runss the file isn't RETURNed. If the file is not 
focal when CATALOG runss CATALDG GETs or ATTACHes the file 
for yous and RETURNs it when it has been CATALOGed. 


un 3 
{optional) User Name in whose catatiog the file is to be 
founds if the file is not in the catalog of the current 
uSeT e 


o or output : 
(optional) name of file to receive the Qutput§ from 
CATALOG. If you don't code the o parameters CATALOG uses 
file output. 


short or long : 
these (optional) keys determine the format of the output 
from CATALOG. If you omit this parameter or code the 
short keys CATALOG produces its output in the form shown 
in the example below. If you code the tong key» CATALOG 
produces its output in the same format as the NOS utility 
CATALOG. 
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See aiso the descriptions of procedures CATBASE and CATLIB which 
provide useful defaulting of the ! and un parameters. 


Example of CATALOG Usage 
This example shows a CATALOG operation performed on a tibrary 
from another user's catatoge The CATALOG procedure obtains the 
fibrarys and returns it when it has finished. 


sesecataliog afiles un=jf73 


CCEFMGR.-OPLC CEDMeceeeDPL CEDTEXT.»eOPL | CIOINT.2e0PL 
CRACK eee oe DPL EDBLD.2eeDPL EFMGReoee PL ENVINIT..OPL 
EPBLDeeeefPL FMTMSGeeeDPL MSGDICT..OPL PINESC oe eDPL 
POUTESC..OPL PUSHERR. -OPL REPERRee eOPL SFSKEOGL.eOPL 
SFWTITLe. ODPL SRCHMSG.-OPL STRTUP..-OPL TES eeeeee ODPL 
AFILE«seeeO0PLD 


* END CATALOG AFILE 
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664 ELLES =_QLSPLAY LOCAL _FILE_INEQRMAIION 


FILES gives you a concise list of information about your local 
files. The output of FILES is a compressed form of the output from 
the NOS utitity ENQUIREsF. Parameters to FILES are ;: 


o or output : 
{optional) specifies the name of the file to receive the 
focal file information. If you don*t code this parameters 
FILES uses file output. 


aff: 
if you code this toptional) keys FILES inctudes in its 
output some files that are normally not included because 
they are aiways present (e.g. INPUT*#¥»s INPUTs and 
QUTPUT). 
Example of FILES Usage 
ses. files 
LBSRC70 42817 PM. UTILSRC 21447 PM* SCLEDIT esoee3 LO 


GROUP es e2212 LOe 
¢ END FILES 


The exampie shows FILES being used to Vist tocal file information 
to the terminal. 
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605 PERMIT = OBTAIN FULL _LIST_OF_ PERMISSION _INEQRMATION 


PERMIT provides you with a permission information for al! files 
in your catalogs or for a selected tist of Files», whereas if you use 
the NOS CATLIST utititys you can onity tist permissions one file at a 
time. Parameters to PERMIT are 3: 


o or output : 
foptional) name of file to receive the Output from 
PERMIT. If you don't code the o parameters PERMIT uses 
File output. 


f or fn 3 
{optional) list of File Names for which you wish the 
permission information to be produced. If you don't code 
the f parameters PERMIT gives the information for ail 
Files in your catalog. 


Example of PERMIT Usage 


sesepermit  fnzproctibd 


CATALOG OF WRB FM/CLSH176 80/10/28. 08.5642. 
PROCLIB 

1. SES READ 3 BO/LOS1 7. 09243018. 

2e SESAUX READ 1 80/10/28. 08444233. 

3e SLE READ 1 80/10/28. 08.50.29. 

4. EFT READ 1 80/10/28. 08.54.58. 


This exampte ittlustrates a typical use of PERMIT. The output 
from the PERMIT procedure is as that of the standard NOS CATLIST 
uti lity. 
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606 LIMITS =_DISPLAY VALIDATION LIMITS 


LIMITS provides you with a condensed version of the display that 
you'd get by using the NOS LIMITS controt statement. The LIMITS 
controt statement uses 35 tines to dispiay the information. By 
using this LIMITS procedures you get that information in five tiness 
thereby conserving Space. Parameters to LIMITS are : 


o or output : 
(optional) name of file to receive the GQutput§ from 
LIMITS. If you don*t code the o parameters LIMITS places 
the display on file OUTPUT. 


Note that this LIMITS procedure formats the LIMITS data such that 
the word UNLIMITED is represented by an asterisk {(*). 


Example of LIMITS Usage 


This example shows the use of the LIMITS procedures and the 
typical output generated by it. 


sesetimits 

UIs612 ABs <AB==s ABz» ABz»s MT=¥y RP#¥y TLets CM2¥5 NF at, 
DB=*, FC#¥®, CS2*y FSs*y PAZEVENs ROeSYSTEMs PX#HALFs TT#TTYs 
TC2ZASCII» IS2BATCHs MS=*5 DF2*¥5 CC® OF =¥y CPe*,y LP, 
EC=*, Silat, CN» PNes DS2*, AW=00007777777700007557 

* END LIMITS 
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67 ILME_~_DISPLAY CURRENT TIME _OF_DAY 


TIME is a quick way of finding the time (to the nearest five 
minutes). The SES TIME procedure "talks" the time as a dayfile 
messages for example ; 


sesetime 
* TWENTY FIVE PAST TWELVE 
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608 DISPLAY _=_DISPLAY VARIOUS USEFUL _INEDRMATION 


DISPLAY provides you with an easy way to ask for the display of 
odd things such as the job control registerss field tengths 
switchess dates time and so one You can request the display of many 
things at a time. The disnolay is formatted in a "dense™ fashions to 
minimize the number of tines of screen used. There are onty two 
parameters to DISPLAY that require valuess the rest are just keys to 
indicate what you want displayed. The two parameters are the expr 
or e parameters described belows and the o parameter which 
determines which file the display goes toe The display goes to file 
ouput by default. keys that indicate to DISPLAY what you want to 
know. You use DISPLAY tike this : 


sesedisplay thingls thing2s thing3s etc. 

where the "things™ are any or all of the keys described here. 

key what's displayed 

expr or e displays the value of any valid SES expression. A list 
of the arithmetic operators available for expressions is 
given in the description of the MATH procedure below. A 
full description of the syntax of expressions can be 
found in the SES Procedure Writer'*s Guide. 

date displays the current date in the form : AUG ls 1978 

time "talks" the time in the form : TWENTY FIVE TO ELEVEN. 


The time given in this form is atways rounded to the 
Nearest five minutes. 


clock disptays the ctock time in the form : 4323 PM 

fi displays your current Field Length 

rl disptays the contents of job control register R1 

r2 displays the contents of job control register R2 

r3 displays the contents of job contro! register R3 

ef dispiays the contents of the Error Flag 

jer dispiays the contents of all four Job Control Registers» 


Rl» R2»s R3 and EF. 


sw displays the six sense SWitches 1 to 6 in ieft to right 
order. 
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displays ALL the above information 


Example of DISPLAY Usage 


sesedisplay ail 

FL = 450008)» RL = 4500» 10624(8)>»s R2 = 0 

R3 = 6789s 15205(8)> EF = Os SW = (FoToFoTsToF) 
JAN 259 19809 TWENTY PAST FOUR 


- END DISPLAY 
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6.9 DAYWEEK = DISPLAY DAY_QF_THE WEEK 


DAYWEEK is used to determine what day of the week any date 
{including today) fell! ons is» or will fall on. Parameters to 
DAYWEEK are 3 


day :? 
{optional) specifies the number of the day in the month. 
If you don't code this parameters, the current day of the 
month fis used. 

month 3: 
(optional) specifies the month either as a number (1.42212) 
or as a string (of which the first 3 characters are 
used). If you dontt code this parameters the current 
month is used. 

year 3 


(optional) specifies the year. Note that all the digits 
of the year must be given. If you don't code this 
parameters the current year is used. 


o or output : 
(optional) specifies the name of the file to receive the 
output from ODAYWEEK. If you don*t code this parameters 
DAYWEEK writes its output to file output. 
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6.10 TOOLDOC =-_ PRINT TOOL DOCUMENT 


TOOLOGC is the means by which on-line and/or of f-itine copies of 
TOOL DOCuments are made available. Parameters to TOGLDGC are : 


docs or d : 


This (optional) parameter is used to indicate which 
document(s) you wish to obtain. Document names are taken 
from the "document number™ column of the document index 
display (see the 'doclist' parameter). The absence of this 
parameter will defauit the proc to dispiay the entire 
document index. 


doctist or df: 


{optional) used to indicate that the document index is to 
be displayed - or retained on a File named by the listing! 
paraneter. The ‘doctist' parameter is ignored if the 
'docs* parameter is specified. Specific portions of the 
document index are displayed by using the folttowing keys 
with this parameter: 

CYBIL - CYBIL Compiler related documents. 


C170 - SES Development and Support tools other than those 
for C180 Project. 

Ci80 - C180 Operating System development documents. 

DTHER - Documents that dontft fit into the categories 
above. 

SITE -=- Documents availiable onty at the locai user's site. 

ALL ~ All of the above categories. This is the default 


if none of the above keys are indicated. 


fisting or 1 3 


bin 


(optional) name of file to receive the document index 
diselay (when using TOOLOGC without specifying any 
document(s))» oc the formatted document(s) themselves. If 
you code the tisting parameter to direct the document(s) or 
the document index to a files that file is not printed. 


(optional) BIN number used at Sunnyvale Development 
Division to indicate the bin number the output is to go 
toe If you don't code the bin parameters, TOOLDOC uses the 
vatue of profile variable userbins and if there's no such 
variabie defineds generates a bin number of NO-ID. 
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6.0 GETTING INFORMATION 
6210 TOOLDOC — PRINT TOOL DOCUMENT 


Note that the standard SES batch job parameters are available. 
The default is to run the job in batch mode. 


Exampte of TOOLDOC Usage 


sesetooldoc arh2739 
10.36.10. SUBMIT COMPLETE. JOBNAME IS AAEQAXA 
* J08 #TOGOOLDOC SUBMITTED 


This exampite would cause the ERS for CYBIL 1/0 to be printed on 
the system line printer. 


sesetooldoc tzdoctist 
* INDEX DISPLAY => DOCLIST 
* TOOLDOC DISPLAY COMPLETED 


This example copies the document index to the file DOCLIST. 


COMPANY PRIVATE 


6-17 
CDC -—- SOFTWARE ENGINEERING SERVICES 
7/30/81 
SES (Release wee) User's Handbook REV: AB 
620 GETTING INFORMATION 
6el1l1. TOOLREP = LIST TOOL REPORT 


Ee hee ee Be Be ee Bl PO OO DE PO PE OPE PE PE PO TE OE TO 08 PO PO PO PE PO OD PE OG PE PEPE P8 D8 PO IE 8 PO TO PE OA PE AE PE OE POPE PE OE PE 98 0 08 8 8 


6ell TQOLRE® = LIST _TOQL REPORT 


TOOLREP provides a display of the current status and/or 
outstanding problems for a specified tool or product. Parameters to 
TOOLREP are 3 


tool or t 2. 
specifies for which tool or product a report is desired. 
Currently», the only supported values for the tool parameter 
are SIM180 (the CYBER 180 Hardware System Simulator), CYBIL 
(CYBIL compilers)» and SCU (Source Code Utility). 


status or problims : 
if one of these (optional) keys is codeds only that portion 
of the report {status or outstanding problems? is 
displayed. If you don't code either of the keys» both 
portions of the report are disolayed. 


(optional) name of file to receive the Qutput from 
TBOLREP. If you don't code the oo parameters the output 
goes to file OUTPUT by default. 

Exampies of TOOLREP Usage 


sesetoolrep sim180 status 


This exampfie of TOGLREP displays the current status of the CYBER 
180 Hardware System Simulator. 


sesetoolrep scu 


This exampie of JTOGLREP displays the current status of the NOS 
170 version of the Source Code Utility and known problems with the 
utility. 
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6012 [NEQ_-=_ ACCESS SES_INEQRMATION 


INFO ts a means whereby users may get up to the minute bulletins 
on changes in SES. Parameters to INFOQ are :. 


0 or output ;: 
(optional) name of file to receive the Gutput from INFO. 
If you don't code the o parameters INFO outputs the INFO 
file to OUTPUT. 


all: 
if you code this (optional) keys INFO gives you ALL the 
information from the INFO file. If you don*t code the all 
keys INFO onty gives you the last record of information 
from the INFO file. 


COMPANY PRIVATE 


6-19 
COC - SOFTWARE ENGINEERING SERVICES 
7/30/81 
SES (Release 17) User's Handbook REV: AB 
6.0 GETTING INFORMATION 
6013 USSDOC - GET USER SUPPLIED SOFTWARE DOCUMENT 


TO PM OE DE PE PE REPO PO PE OD PE OO PE PO RE HE PO OO OE FE PE PO PO PE PE OE PE OE PE 88 PG 8 8 PE BG PO PE TE PO PA TE FO P8 PD DE 8 O8 PE PE PE ON RO PE OE OE D8 HO PE P0 PE OO 98 PE 88 PN Pe 


6013 USSO00_ =_GET_USER_ SUPPLIED SOFTWARE DOCUMENT 


ussSDOC is the means by which on-fine copies of User Supplied 
Software documents are made availabie. Parameters are 3: 


product or pr : 
This (optional) parameter is used to indicate which 
document you wish to obtain. Document names are the same 
as the product itself. The absence of this parameter will 
defauit the proc to display a catbase listing of what is 
available on the document file. 


fisting or 1 3 
{optional) name of file to receive the document you wish to 
retrieve. If you don*t conde ths 1! parameters the output 
appears on file LISTING. 


Example of USSDOC Usage 


SESeUSSDOC PR#GET L2LISTOUT 
* END uSSDOC GET -> LISTOUT 


This example retrieves documentation on GET to the file LISTOUT. 
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6014 USSINEO =_ ACCESS _USS_INEQRMATION 


USSINFO is a means whereby users may get up to the minute 
bulletins on changes in User Supplied Software. Parameter(s) to 
USSINFO are 3. 


o or output : 
{optional) name of file to receive the output from 
USSINFO. If you dontt code the oOo parameters USSINFO 
outputs the USSINFD file to OUTPUT. 
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6015 SESPROC =_LIST_SES_ PROCEDURE NAMES 


SESPROC displays a fist of procedure names already used by SES. 
This is of use if you are a procedure writer and wish to create new 
procedures for use in SES.» You can then use SESPROC to ensure that 
there isn't any name conflict. Parameters to SESPROC are ; 


un 3 
(ootional) list of user names whose catalogs are to be 
searched for procedure tibraries. SES uses the SES 
Library NAMe as the name of the procedure library to took 
for. If you don't code the un parameters SESPROC displays 
the names of procedures in the PROCLIB of the current 
users and the names of procedures on SES tibrary. 


0 or output : 
(optional) name of file to receive the Output from 
SESPROC. If you dontt code the o parameters SESPROC uses 
file output. +s 


Example of SESPROC Usage 0 


sesesesproc un=ed73 eo 
UN = ED73 i 
CETGEN COLLDOC COiLSUB EDTDAC EDTMOD EOTSUB 
ICGEN MOVDOC MOVSUB PERT PRTDOC PRTSUB RELDOC oe 
RELSUB REPDOC REPSUB SENDKC WIPEDOC WIPESUB 4 
* END SESPROC 4 


This example shows SESPROC used to determine the names of see 
procedures in the PROCLIB of user ed73. 4 


3 
‘ 
ty 
ra 
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6e16 SESPARM_ = PRINT PARAMETER REQUIREMENTS. FOR_ SES PROCS 


SESPARM prints out the parameter definitions for at! 
procedures on alibrary. It runs batch or local with batch as 
defauit. Parameters to SESPARM are 3: 


name of Library whose parameters are to be printed. 


{optional) User Name where the ftibrary is to be found 
you: don't code the un parameters SESPARM assumes that 
library is in the catatog of the current usere 


o or output or fisting : 
{optional) name of file to receive the Output of SES 
If you don*t code the o parameters the output appear 
file LISTING, 


batch job parameters : 
These parameters are described in section 1.7 - 
PROCEDURES RUN AS BATCH JOBS". The default § for 
procedure is to run in batchn modes but it can be r 
focal mode. The dayfile parameter is not used by 
procedure. 


print : 

(optional) parameter to control the PRINTing of 
output. When the job runs in batchs one copy is op 
automaticalty. If you run the procedure in local mod 
copies are printeds unless you specifically code 
print parameter. For examples you could code printzc 
obtain three copies of the parameter Jisting.e The f 
of the print parameter is that of the parameters fo 
PRINT procedure. 


Note that the parameter tftist of each procedure must term 
with a PARMEND directives ors for those records in a tlibrary 
don't have a PARMEND directive by virtue of the fact that th 
INCLUDE files» the parameter fist must be terminated by a 
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" \ PARMEND * 


Example of SESPARM Usage 


sesesesparm tzprocitib unszhk77 ftocal noprint 


DEBUG | 
\ PARM KEY = *f? NVALS = 1..MAXVALS NAM 
\ PARN KEY = (*args*s %al) NVALS = 1 STR 
\ PARM KEY = tp? | NVALS = 1..+MAXVALS NAM 
\ PARMN KEY = #48 NVALS = 1 NAM 
\ PARM KEY = *e?* NVALS = 1..MAXVALS STR 
\ PARN KEY = *xtd? NVALS = 1.-¢MAXVALS STR 
\ PARMEND 

RSBBVWseecrerszesz 
DBUGFIN 
\ PARM KEY = (8i%, *"f°) NVALS = 1 NAM 
\ PARM KEY = ‘9! NVALS = 1 STR 
\ PARM KEY = ‘bf NVALS = 1 STR 
\ PARM KEY = ‘fio NVALS = 1 NAM 
\ PARMEND 


¥ END SESPARM PROCLIB/HK77 -> OUTPUT 


Aftthough this is a rather contrived exampie of a procedure 
library with only two procedures in its it iltftustrates the output 
that SESPARM generatese SESPARM is run in tocal modes or while you 
waits to produce the parameter definitions for procedures in tibrary 
Proctib in the catatog of user hk77. The noprint key inhibits 
printing of the generated output. 


Explanation_of the output of SESPARM 


The diagram on the next page shows the alternative forms of 
parameter definitions of SES procedures. Aiternative forms are 
arranged in the vertical columns. The blocks of text below provide 
a brief description of each fieid of a parameter definition. 
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This command starts 
the definition of an 
SES PARaMeter. 


G6 Oe O26 BO oO OO 


KEY specifies the key- 
word or keywords that 
may be used when coding 
@ parameter for an SES 
procedure. 


GG Of GH GH 4H GO 6H BE GO 86 4H OH 


NVALS specifies the Number of VALues 
that may be coded for a parameter. The 
form mineemax indicates that a minimun 
of “min"™ vailuess and a maximum of “max" 
values may be coded. If onty one number 
is specifieds it means that the min and 
max are the same. If NVALS specifies a 
value of zero (0)5 then tt Indicates 
that there may be no vatues codeds and 
that the parameter keyword is used as an 
option key. NVALS specified as O«.max 
indicates that the keyword may be used 
as an options or that it may be given 
values. 


SO 2H 28 BE SH BO 66 OH 426 2H BH GH CH OH OH 4H GH 4H BEG OH 4H 4H 4H BO BO 24 GH HO 


This field indicates the parameter type. It may 
be NAMes NUMbers STRings or ForeiGN text. Refer <---+ 
to the INTRODUCTION section for a description of 
parameter types. 


If this fieid is coded in the parameter 
descriptions it indicates that that parameter is <------- 
REQuireds and therefore may not be omitted. 


+> OS SH OF O26 B28 2H SH SH OH O46 BH 64 60 66 4H OO HH BH 04 OH OH GE 06 HH HO GH 48 HE 4H OH 66 HH on} 


If this fietd is coded in the parameter 
descriptions then it indicates that parameter 
vatue(s) may be coded as a RaNGes that iss in the 
form firsteelast 


Ca BH SOO OH SE OG 2H 4H OG SE BH OH BH OH SE CO BH OF £26 HO HH GH BGO 4H HE BE OO CH OH 4H GH HO 40 BH OH HE CO we f 
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7-0 ELLESPACE_ MANAGEMENT 


SES provides some useful utilities to aid you in handling your 


files. 


RETAIN 


DUMP PF 
LOADPF 


REWRITE 


The procedures described here are : 


GETs or ATTACHes all your files to stop them being 
archived. 


interfaces to the Minnesota Dump and Load utility to 
provide easy to use dumping and toading of Files. 


provides a "safe" way to rewrite a file after it has been 
modified. . 
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7el RETAIN =_ACCESS_ALL_ELLES_IN_USERSS CATALOG 


RETAIN GETs or ATTACHes all your files to ensure that they aren't 
archived. RETAIN aiso provides the facility to CATALOG either 
designated files» or all OIRECT access files in your catalog. 
Parameters to RETAIN are ;: 


batch job parameters ; 
These parameters are described in section 127 - "SES 
PROCEDURES RUN AS BATCH JOBS". RETAIN runs in batchn mode 
by default. RETAIN doesnit use the dayfile parameter. 


c or noprint : 
(optional) coding c alone as a key causes all DIRECT 
access files in the catalog to be CATALOGed. Coding a 
list of files for c causes onty those specified files to 
be CATALOGed. Coding the noprint key suppresses all 
output From RETAIN.» 


s or short : 
coding the (optional) short key directs RETAIN to generate 
a short SES stytfe CATLIST output instead of the NOS tong 
form CATLIST. RETAIN generates the NOS styte tong form 
CATLIST by defauit. 
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7e2 DUMPPE_4_LOADPE_ = _DUMP_/_ LOAD PERMANENT FILES 


DUMPPF and tLOADPF interface to the DUMPPF and LOADPF system 
utilities (the so called Minnesota Dumpers) They’ provide a 
reasonably easy to use means of dumping files to magnetic tape and 
retrieving them when required. Your only probtem is: whether you 
want to trust tapese Parameters for DUMPPF and LOADPF are almost 
the sames so they are described togethers with variations explained 
as required. Parameters are 3: 


$ 
fiie or files : i 
(optional) tist of files to be processed. If you don't 
give any file namess all files (or files determined by 
other setection criteria) are dumped. 


tape or vsn ;: 
(optional) number of the tape to be used for the dump or 
load. tape is intended for ‘standard! library tape 
numbers. If you have tapes with visual tabels such as 
ABCO23 {a typical CANCDD number) or aU or T tape (SDD User 
or Temporary tape)s you use the special parameter described 
later. 


pn or pack or packnam : 
(optional) name of user pack on which the files are to be 
processed. If you dontt specify a pack names files are 
accessed from the family. 
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The next six parameters are the options for a tape REQUEST 
commande They alt have defaults and they can all be specified via 
PROFILE variables. The parameters are described in the tabte below 
For easier references 


0 DD ae ee en eS em ie ED ee ep ee ee ee 


Parameter 
Keyword 


SD EE SES RG AED ND AE ND ED OE 8 ED ee 


seven or amt 
nine or ant 


OD AAS INE ANS “atin -etiete EIR ARR Ae een sa sae A SAND ED EY NN OU AN i a <a. 


Profile 
Vaciable 


RP tees ED Oe ED A ee ae 


{ 
| 
i 
' 
' 
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t 
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' 
' 
! 
| 
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Parameter Usage 


A ND aR) AND Ch Ee A em SO ee ee LAP A A I LAS NOD SAGE ES EO RD EN UE ERT ES NNN EE A AED ANN EAD SE “AD END 


indicates whether to 
use seven or nine 
track tape. The 
default is to use 
nine tracks (NT). 
tape density to be 
useds The tfetters 
you use to indicate 
this have to be 
different depending 
on whether it's seven 
or ks track. 

tape Ssewae- to uS@s 
The defauit is I>» 
that iss NOS 
Internal. 

tape LABEL 
specification. The 
default is Kbk»s that 
iss KRONOS LABELLED. 


ED Eb ED HD ED ND Oe a em a Ee ee ee ee ee ee ee ae ee 


dor danci ey 


Capeden 


f or format 


2008 SUP 2a aE ee ee ee Aen ae ne > Ge A ee ee ee cen a 


R (load) 
W (dump) 


7 win ee a ae a em om 


Processing Qptions to 
be usede The 
defaults are PO#R for 
a LOADPF and POW for 
a DUMPPF, 

iadicetes seeebal 
tape names or numbers 
as mentioned above in 
the description of 
the eee parameter. 


he <b cn can Nb ate ae aoe Eb aD Eh aD ae ei ane ee AD Ce EAD AC A ED ED OD ED eit EI ne cae le ee ER) Se ee em ee 


em 06 we He oe HH 6d Oe He me 6h Oe Oe 68 On a8 4 HO Oe ch OH 4 On OO 48 4H Oe be ee He oe Ow od oe ee HH ee BE 
- on 2m ae 08 40 hb 68 we Oe OH 2 OO we we bk Oe hh HE Oe Oe Bk he 86 Oe Oe ee ee Oe em Bee we 
> we ce 66 oo se } 6H we HO Oe BO He } Be CO 08 He HH bE OH Be OE he HE Oe be OO He oe be > Ae Ok Oe oe oe ne he He oe + 


68 we Oe Be be } BO 6 66 28 BO Oe GH be OO om OH hy HO Oe OO tt Hh Oe OO Ae He ee Oe He Oe Oe oe ne dp om we bp 
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catalog or itemize : 
coding one of these (optionat) keys causes the CATALOG or 
ITEMIZE utility to process the tape to give a list of 
records on the dump. If these options are selected» the 
tape is rewound before and after the operation. 


The next five parameters control the DUMP/LOAD processe The most 
used things are supplied by specific keywords and the xp parameter 
is used as a catch alt for anything else you might want to do. 


ty or type : ; 
{optionalt) [TYPE of files to process. If you don't code the 
type parameters TY=ALL is used. Qther options are TY#I (to 
process onty Indirect files) or TY=#D (to process only 
Direct files). The DUMPPF/LOADPF procedure doesn't check 
the validity of any options you code here. 


fo : 
this foptional) key directs DUMPPF/LOADPF to process LOCAL 
files onty. Normallys permanent files are processed. 


ma or noabort =: 
this (optional) key directs DUMPPF/LGADPF to NOt ABORT if 
any errors are encountered during processing. The normal 
default is to abort. 


np or nopurge : 
this Cloptional) key is onty applicabie to LOADPFs and it 
directs LOADPF to NOt PURGE atready existing files when 
foading. This means that already existing permanent files 
are skipped on the toad. The normal mode is that existing 
permanent files are purged before toading. 


(optional) eXtra Parameters for DUMPPF/LOADPF. You code 
this in the form of a character stringe The examples at 
the end should clarify it. 


tt or ftoctape : 
(optional) Local TAPE name for the tape request. 
DJUMPPF/LOADPF normally requests the tape as a unique namee 
If you are running DUMPPF/LOADPF as part of a larger jobs 
and you want access to the tape outside the process» you 
can give your own name to the tape by coding the ltoctape 
parametere 


batch job parameters ; 
these parameters are described in section 1.7 - “SES 
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PROCEDURES RUN AS BATCH JOBS" = of the SES USER'4Ys 
Handbook. OUMPPF/LGADPF run in batch mode by default. 


Exampties of DUMPPF / LOADPF Usage 


sesedumppf tape 666 
07248.35- SUBMIT COMPLETE. JOBNAME IS AGRIBUS 
* J08 DUMPPF SUBMITTED 


This is the simptest example of DUMPPF usages your entire catalog 
is dumped to tape 666.2 The REQUEST statment that SES generates for 
the dump tooks like this 3. 


SREQUEST(ZOxxxxxsNTsD=PEs Fal so LB=KL» PO=Ws VSN2000666) 


Note that DUMPPF / LOADPF fill in the leading zeros in the VSN in 
the tape request if they are required. Now for aestightiy more 
complex example : 


sesedumppf (wilsonsheathsnixonsagnen)s specialzabcl23sceceee 
oe? pozswunes dzhy 

192172154 SUBMIT COMPLETE. JOBNAME IS ABXTCUB 
* JQ0B DUMPPF SUBMITTED 


In this examptes the four fifes in the parenthesised ftist are 
dumped to tape ABC123. The tape Processing Qptions (the po 
parameter) are set to WUNE»s and the tape Density (the d parameter) 
is set to HY (800 bpi) instead of the default PE (1600 bpi). 


seseloadpf tape 789s nopurges pack ftns xpz'ctzspriv? 
160422554 SUBMIT COMPLETE} JOBNAME IS ADRQBIT 
* JOB LOADPF SUBMITTED 


This example loads all your semi-private files {specified via the 
xp parameter in the exampte) onto the FTN) pack (the pack 
parameter). Note that the nopurge key is codeds so that already 
existing permanent files are skipped during the toad of files from 
tape 000789. 


COMPANY PRIVATE 


7-7 
CDC - SOFTWARE ENGINEERING SERVICES 
7430/81 
7.0 FILESPACE MANAGEMENT 
7.3 REWRITE - REWRITE FILE 


PO OE POPE PE PE PO 8 OO PE PE PE PO OO POPE Pb TO D8 OE FO OF PE PD PE PE PO PO PE FE PA OR OE OF PE FE PE TE PO PE PE OD FE 20 FE OE PE DE PE OE FO OF OE FE PE AO 28 OE OF 70 PE 88 RO HE ON 8 Ae 


7+3 REWRITE -_ REWRITE FILE 


REWRITE is matinty used as a building block for the source text 
maintenance and Jibrary management proceduress where rewriting of a 
base or library is required. REWRITE is a "safe" way of performing 
the overwrite process. If for some reason REWRITE fails to perform 
the rewrites it tries Five (5) times before it gives up. Parameters 
to REWRITE are : 


ioor rewriti : 
name of Inout file to REWRITE. 


o or rewrito ; 
name of Qutput file after the REWRITE process is 
comolete. This is the new file created by the rewrite. 


un or rewritu 3 
(optional) User Name in whose catalog the file specified 
by o is to be founds if it isn't in the cataiog of the 
current user. If you don't code the un parameters REWRITE 
uses the user name of the current user. 


failed or rwfaild : 
{optionai) tabelf to which REWRITE is to GO TO in the event 
that the rewrite fails. If you don't code the failed 
parameters in the event of a failures REWRITE performs an 
EXIT. 


foopend or rwloopd ? 
{optionat) tabel to which REWRITE is to GO TO if the 
rewrite cannot be performed after five attempts. 


msg or nomsg ; 
these (optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - “INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 


Note : If the new file (given by the o parameter) is an existing 
INDIRECT access files it is REPLACEd. If the new File is an 
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existing DIRECT access files REWRITE performs an overwrite orocess 
by ATTACHiIng the file in WRITE mode» If the new file doesn't exists 
REWRITE DEFINES the new file as a DIRECT access READ mode File 
(thiss of courses can onty be done if the un parameter is omitted or 
is given as the user name of the current user). 
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8.0 COMPILING: LINKING: AND DEBUGGING 


This section describes the SES procedures available for compiling 
{assembling) programs written in various languagess and for linking 
relocatables into executabie form. The procedures currently 
availtabie in this category are ;: 


CYBIL run the CYBIL CC or CYBIL CI compiler. 

ISWt run the ISWL CC compiler. 

SYMPL run the SYMPL compiler. 

FTN run the ForTraN extended compiler. 

FINS run the ForTraN-5 compiler. 

COMPASS run the CPU/PPU ASSembler for the CYBER 170. 

CPAS180 run the CPu ASsembter for the CYBER 180. 

PPAS180 run the PPu ASsembler for the CYBER 180. 

LINK170 tink relocatable binaries to form an absolute program. 
GETCCDB gets the CYBIt CC Interactive Debugger ready for use. 


GETLIB(S) get CYBIL run time tibrary tocal to the job. 
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Sel CYBLL =. RUN CYBIL CC OR CyBIL_CI_ COMPILER 


CYBIL runs the compiler for the CDC CYBER IMPLEMENTATION 
LANGUAGE. Two compilers are availabfte: CC to generate code to be 
run on a CYBER 170 machines and CI to generate code to be run on a 
CYBER 180 machine. 


The procedure is arranged so that if there are any compife-time 
errors detecteds the NOS Job Control! Register called EF is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building blocks to determine what steps should be taken 
subsequent to running the compiler. 


Parameters to the CYBIL procedure are : 


for f 3: 
{optional) name of Input File to be compited. If you 
don't code the i parameters CYBIL assumes that the input 
is on a file catted compile. 


bead 
oe 


toptional) name of fite to receive the Listing from the 
compifter. If you don*t code the 1! parameters the compiler 
output appears on a file called tisting. This fisting 
file is not rewound by the CYBIL procedure. 


(optional) name of file to receive the Binary object code 
generated by the compiler. If you don'tt code the 0b 
parameters the binaries appear on a File caltted tgo. This 
igo file is not rewound by the CYBIL procedure. 


cc or ci : 

these (optional) keys determine which of the compilers is 
usede If you don't code either of these keys or if you 
code the cc keys the CYBIL CC compiler ts used. If you 
code the ci keys the CYBIL CI compiler is used» Note ;: 
you can set your own default compiter selection in your 
profile be setting a variable called cybil to one of these 
keySe 


Note : this parameter is used to select a version of the 
CC or CI compiler other than the standard ane released via 
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Sel CYBIL - RUN CYBIL CC GR CYBIL CI COMPILER 


chk 


io 


3 


the SES. This is done by coding as a vatue for this 
parameter the user name of the owner of the compiler 
you're after. For examples entering cctip3 accesses the 
version of the CC compiler residing in the LP3 catalogs 
It is necessary for the owner of such a compiler to use 
the file name CYBILC for the CC version and CYBILI for the 
CI version in order to allow the compiler to be accessed 
via this procedure. 


this f(optional) parameter specifies the run-time checks 
the compiler is to generate. If you code gg for this 
parameters no run-time checking code is generated. If you 
code any combination of n (check for de-reference of NIL 
pointer)s oc (check value ranges--range checking may add as 
much as 3 1/2 words to the generated object code for each 
range check performed) ands (check subscript ranges)» the 
corresponding checking code is generated and omitted 
checking options cause the corresponding checks to be 
suppressed. If you omit the chk parameters CYBIL 
generates ali flavors of run-time checks. 


this (optional) parameter specifies the Options to be used 
when producing the Listing. Any combination of the 
following designators may be coded for this parameter : 


a specifies that a map of the source Input biock 
structure and stack is to be produced 


f specifies that a full listing is to be produced 
{selects tist options Ss» As and R) 


o specifies that the tisting should include the generated 
object code in an assembier-tike format 


s specifies that the listing of the source input file is 
to be produced 


w specifies that the fisting of warning diagnostic 
messages is to be suppressed 


r specifies that a symbolic cross reference tisting is to 
be produced 


ra specifies that a symbolic cross reference tisting of 
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ail program entities is to be produced whether 
referenced or not 


x works in conjunction with the LISTEXT pragmat such that 
LISTings can be EXTernally controlled via the compiler 
cali statement. 


If no is specifieds no listing is produced» If the to 
parameter is omitteds a listing of the source input file 
oniy is produced. 


debug or d or nodebug : 


pad 


this (optional) parameter is used to select the debug 
options to be in effect for the compilation. The 
availabile debug options are 2: 


sd If this option is selected» the compiter includes 
Symbol Table information in the object code file to 
be used by the CYBIL interactive debugger. If this 
option is not setected it isn?t possible to 
symbolically debug the module(ts) being compiled. 


fd This option produces the same tables as dzsd plus 
stylizes the generated code to provide a step 
facility when using the symbolic debugger (it is only 
meaningfuls currently» when used with the cc 
compiter). 


ds If this option is selected the Debugging Statements 
appearing between 22 nocompile 2? and 
272? compile 2? pragmats is compileds otherwise such 
statements are skipped by the compiler. 


If you omit this parameter or you code the nodebug key» 
none of the sds fdor ds options are selected. If you 
code the debug or d keys but don't code any vatluess 
debugz=sd is used. To select combined options you can code 
debug=(sdeds) or debug=(fdsds). 


coding a numeric value for this (optional) pad parameter 
generates the specified number of no~-ops between machine 
instructions. This feature is used for the P3 
diagnostics. 
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opt : 
this (Coptional) parameter is used to select optimization 
levels in the (CI only) generated code. Legitimate values 
are 3 


0 Provides for keeping constant values in registers. 
1 Provides for keeping tocai variables in registers. 


2 Eliminate redundant memory references. 


™Ssg or nomsg ?: 
these (optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - “INFORMATIVE MESSAGES FROM SES 
PROCEDURES", 


Example of CYBIiL Usage 


sesecybil toz%or*s chks*sn? 
* END CYBIL COMPILE => LISTINGs LSGO 


This example shows the CYBIL CC compiler being used to process 
the program on file COMPILE.’ A tisting is produced consisting of 
the source input» generated object codes and a symbolic cross 
references on file LISTING. The object code is written to file tUGO 
and will include run-time checking code for Subscript ranges and NIL 
pointer de-reference. ; 
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8o2 LiWl = RUN TSWL_CC COMPILER 


ISwWl runs the ISwl CC compiter. 


The procedure is arranged so that if there are any compile-time 
errors detecteds the NOS Job Control Register called EF is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building biocks to determine what steps should be taken 
subsequent to running the compiler. 


Parameters to the ISWL procedure are 3; 


ior f : 
{optional) name of Input Fite to be compiled. If you 
don't code the i parameters, ISWL assumes that the input is 
on a file calied compite. 


{optional) name of file to receive the Listing from the 
compiler. If you don*t code the ! parameters. the compiler 
output appears on a file calied tisting. This tisting 
file is not rewound by the ISWL procedure. 


b 3 
{optional) name of file to receive the Binary object code 
generated by the compiler. If you don't code the 6b 
parameters the binaries appear on a file calied Igo. This 
tgo file is not rewound by the ISWL procedure. 

fo 3: 


if this (optional) parameter is specified as cs a symbolic 
cross Reference map is produced on the file specified by 
the { parameter. (R is the onty List Option availiable 
with this ISWL procedure.) If you don't code this 
parameters ISWL does not produce a cross reference. 


smaliloor medium or targe : 
these {optional) keys are used to select the size of the 
ISWL compiler to be usede As you might have atready 
guesseds three sizes are available. The default is medium 
but this can be over-ridden by defining in your profile a 
variable catied iswisiz set to one of these keys. The 
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compiler size determines how tlarge aé module can be 
compiled. 


debug or nodebug :? 
these (optional) keys select whether you want the compiler 
to generate (in the object code file) information for the 
ISWL DEBUGger which runs under the SES SUBSYStem. If you 
code the debug key» ISWL generates the debug information. 
If you code the nodebug key or if you dontt code either of 
these keyss ISWL does not generate the debug information. 


msg or nomsg ; 
these (optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 ~- "INFORMATIVE MESSAGES FROM SES 
PROCEDURES”. 
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823 SYMPL_=_RUN_ THE SYMPL_COMPILER 


This procedure runs the SYMPL compiler for the CYBER 170. 


The procedure is arranged so that if there are any compile-time 
errors detecteds the NOS Job Control Register calted EF is set to a 
non-zero valuee This feature is used when this procedure is being 
used as a bullding blocks to determine what steps should be taken 
subsequent to running the compiler. 


Parameters to the SYMPL procedure are 3 


ior f 3 
{optional) name of Input File to be compiled. If you 
don't code the i parameters SYMPL assumes that the input 
is on a file calfed compite. 


(optional) name of file to receive the Listing from the 
compiler. If you dontt code the ! parameters the compiler 
output appears on ai file called listing. This listing 
file is not rewound by the SYMPL procedure. 


se 
oo 


(optional) name of file to receive the Binary object code 
generated by the compiter. If you don't code the b 
parameters, the binaries appear on a file called tgo. This 
{go file is not rewound by the SYMPL procedure, 


fo : 
this (optional) parameter is used to specify the List 
Options for the compilation {see the SYMPL reference 
manual for tegafl tist options). If you dontt code this 
parameters SYMPL uses only tist option L. 


this (optional) parameter is used to pass eXtra Parameters 
to the compiter (see the SYMPL reference manual for a tist 
of allowed SYMPL controt statement parameters). If you 
want to pass extra parameterss the tist of them must be 
specified as a string (within singte quotes). The SYMPL 
procedure does not check the validity of the parameters in 
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the string. If you don't code this parameters no extra 
parameters are passed to the compiler. 


debug or nodebug ; 
these (optional) keys select whether you want the compiter 
to generate information for the CYBER Interactive Debugger 
(CID). If you code the debug keys SYMPL includes the 
debug information in the object code file. If you code 
the nodebug key or if you don't code either of these keysys 
SYMPL doesntt generate the debug information. 


msg or nomsg : 
these toptional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 — "INFORMATIVE MESSAGES FROM SES 
PROCEDURES", 
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844 EIN =_RUN_THE_FIN_(EQRTRAN_EXTENDED) COMPILER 


This procedure runs the FIN (ForTraN extended) compiler for the 
CYBER 170. 


The procedure is arranged so that if there are any compile-time 
errors detected» the NOS Job Control Register called EF is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building blocks to determine what steps should be taken 
subsequent to running the compiler. 


Parameters to the FTN procedure are :. 


ior f 3 
(optional) name of Input File to be compiled. If you 
don?t code the i parameters FIN assumes that the input is 
ona file called compile. 


(optional) name of file to receive the Listing from the 
compiter. If you don't code the ( parameters the compiter 
output appears ona file called tftisting. This tisting 
file is not rewound by the FIN procedure. 


(optional) name of file to receive the Binary object code 
generated by the compiler. If you dontt code the 0b 
parameters, the binaries appear on a file calied tgo. This 
igo file is not rewound by the FIN procedure. 


fio: 
this Coptional) parameter specifies the Field Length to be 
used white funning the compiler. If you don't code this 
parameters FIN uses a field tength of 70000(8). 


this Cootional) parameter is used to pass eXtra Parameters 
to the compiler (see the FIN reference manual for a tist 
of allowed FIN control statement parameters). If you want 
to pass extra parameterss the tist of them must be 
specified as a string (within singte quotes). The FIN 
procedure does not check the validity of the parameters in 
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the string. If you don't code this parameters no extra 
parameters are passed to the compiler, 


debug or nodebug : 


these (optional) keys select whether you want the Sone er 
to generate information for the CYBER Interactive Debugger 
(CIO). If you code the debug key» FIN includes the debug 
information in the object code file. If you code the 
nodebug key or if you dontt code either of these keyss FIN 
doesn?t generate the debug information. . 


4 


& 


msg or nomsg : } 
these (optional) keys control the generation of \ 


informative messages by this procedure and are fully ‘ 
described in section 1.8 — “INFORMATIVE MESSAGES FROM SES 4 
PROCEDURES”, | J 


"iy a. gt DB ag misses 
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8e5 ELINS_=_RUN_THE FINS _ CEQRTRAN-3)_ COMPILER 


This procedure runs the FIN5 (ForTraN-5»s gatso known as 
Fortran-77) compiler for the CYBER 170. 


The procedure is arranged so that if there are any compite~-time 
errors detecteds the NOS Job Controti Register called EF is set to a 
non-zero vaiue. This feature is used when this procedure is being 
used as a building blocks to determine what steps should be taken 
subsequent to running the compiler. 


Parameters to the FINS procedure are 3: 


ior f 3. 
{optional) name of Input File to be compited,. If you 
don't code the i parameters FINS assumes that the input is 
on a file called compile. 


(optional) name of file to receive the Listing from the 
compiler. If you don't cede the { parameters the compiler 


output appears on a file catled tisting. This tisting | 


file is not rewound by the FINS procedure. 


(optional) name of file to receive the Binary object code 
generated by the compiter. If you don't code the 0b 
parameters the binaries appear on a file called tgo. This 
fgo file is not rewound by the FINS procedure. 


fl. 3: 
this (optional) parameter specifies the Field Length to be 
used white running the compiler. If you don't code this 
parameters FINS uses a field length of 70000(8). 


xp 
this (optional) parameter is used to pass eXtra Parameters 
to the compiter (see the FINS reference manual for a fist 
of allowed FINS control statement parameters). If you 
want to pass extra parameterss the list of them must be 
specified as a string (within single quotes). The FTN5 
procedure does not check the validity of the parameters in 
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the string. If you dontt code this parameters no extra 
parameters are passed to the compiter. 


debug or nodebug : 
these (optional) keys seftect whether you want the compiler 
to generate information for the CYBER Interactive Debugger 
(CID). If you code the debug keys FINS inciudes the debug 
information in the object code file. If you code the 
nodebug key or if you don't code either of these keys» 
FINS doesntt generate the debug information. 


™Sg or nomsg ;: 
these (optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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8.6 COMPASS _=_RUN_THE COMPASS _ ASSEMBLER 


COMPASS runs the CPU/PPU assembiter (COMPASS) For the CYBER 170. 


The procedure is arranged so that if there are any assemble-time 
errors detecteds the NOS Job Control Register called EF is set to a 
non-zero value. This feature is used when this procedure is being 
used as a buitding blocks to determine what steps should be taken 
subsequent to running the assembler. 


Parameters to the COMPASS precedure are : 


ior f 3 
{optional) name of Input File to be assembled. If you 
don't code the i parameters COMPASS assumes that the input 
is on a Fite catied compile, 


(optional) name of file to receive the Listing from the 
assembler. If you dontt code the t parameters the 
assembler output appears on a file calied fisting. This 
listing file is not rewound by the COMPASS procedure. 
(Note that the assemblers contro! statement parameter 0 
is set to the same file as specified by the L parameter 
oniy when the nomsg option (see below) is specified.) 


{optional) name of file to receive the Binary object code 
generated by the assembler. If you don't code the 6b 
parameter, the binaries appear on a file called tga. This 
Igo file is not rewound by the COMPASS procedure. 


this (optional) parameter specifies the Field Length to be 
used while running the assembier. If you don't code this 
parameters, COMPASS uses a fietd tength of 7000078). 


oe 


xp 
this {oretional) parameter is used to pass eXtra Parameters 
to the assembler (see the COMPASS reference manual for a 
fist of allowed control statement parameters). If you 
want to pass extra parameterss the list of them must be 
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specified as a string (within single quotes). The COMPASS 
procedure does not check the validity of the parameters in 
the string. If you don't code this parameters no extra 
parameters are passed to the assembler. 


™Sg or nomsg : : 
these (optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 ~ "INFORMATIVE MESSAGES FROM SES 
PROCEOURES",. 
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8e7 CPAS180_~-_RUN_THE CPU ASSEMBLER _ FOR THE CYBER_180 


CPAS180 runs the CYBER 180 CPU assembter. The procedure has two 
modes of operation : 


le "normal mode" in which object code is generated from the 
source program 


22 “systext mode" in which a “system text" file is produced 
{containing pre-assembled PROCss etc.) that is used Jater as 
input to "normal  mode™ assemblies (see the BLDSYST keyword 
parameter described betow) 


The procedure is arranged so that if there are any compile-time 
errors detecteds the NOS Job Control Register calied EF is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building blocks to determine what steps should be taken 
subsequent to running the assembler. 


Parameters to the CPAS180 procedure are : 


for f : 
{optionai) name of Input File to be assembied. If you 
don't code the i parameters CPAS180 assumes that the input 
is on a fite calted compile. 


(optional) name of file to receive the Listing from the 
assembler. If you don't code the parameters the 
assembler output appears on a file calfted tisting. This 
listing file is not rewound by the CPAS180 procedure, 


b 3 
(optional) name of file to receive the Binary object code 
generated by the assembler. If you don't code the 0b 
parameters the binaries appear on a file catted tgo. This 
igo file is not rewound by the CPAS180 procedure. 

chk : 


this (optional) parameter determines whether the assembier 
checks for correct register types and instruction 
formats. If you code no for this parameters no checking 
of types and formats is done and the assembter runs 
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fi 


“ 


bidsyst 


faster. If you code yes for this parameter or if you omit 
the parameters, the assembler performs the checks. 


this Coptional) parameter is used to specify the name of a 
System text file. In "normal mode” this parameter is used 
to provide an alternate to the standard "SYSTEXT"™ used by 
the assembler. In the "build system text mode"s this 
parameter specifies the name of the file on which the 
system text is written (default Is SYSTEXT). 


this (optional) parameter specifies the Field Length to be | 
used white running the assembler. If you don't code this 
parameters CPAS180 uses a field length of 70000(8). 


4 
od 


if you code this loptional) keys CPAS180 runs in the 
"BuilD SYStem Text" mode. If you don't code this key» 
CPAS180 runs in "normai™ mode. 


msg or nomsg : 


these (optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES™,. 
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88 PPAS180_-=_RUN_ THE PPU_ ASSEMBLER FOR THE CYBER_180 


PPAS180 runs the CYBER 180 PPU assembler. This assembler is a 
modified version of standard CYBER 170 COMPASS so that usage of the 
two assembiers is very similar. 


The procedure is arranged so that if there are any comoife-time 
errors detecteds the NOS Job Control Register catted EF is set to a 
non-zero valuee This feature is used when this procedure is being 
used as a building blocks to determine what steps should be taken 
subsequent to running the assembler. 


Parameters to the PPAS180 procedure are : r 


ior f 2 
{optionai) name of Input File to be assembied. If you 
don't code the i parameters PPAS180 assumes that the input 
is on a file calted compile. 


{optional) name of file to receive the Listing from the | 
assembler. If you don't code the & parameters the, 
assembler output appears on a file caited tisting. This} 
fisting file is not rewound by the PPAS180 procedures] . 
(Note that the assembier*s control statement parameter O8§:.. 
is set to the same file as specified by the L parameter)... 
onty when the nomsg option (see below) is specified.) Ge 


i 

A 
i ‘t é es 
: i : 


Coptionat) name of file to receive the Binary object code , 

generated by the assembler. If you don't code the b 

parameters the binaries appear on a file called Igo. This + 

'go file is not rewound by the PPAS180 procedure. 4 
EY 


fi 3: | 
this Coptional) parameter specifies the Field Length to be 
used while running the assembier. If you don't code this ,,. 
parameters, PPAS180 uses a field fength of 7000018). 


oo 


2 : 
this Coptional) parameter is used to pass eXtra Parameters | 
to the assembler {see the COMPASS reference manual for a 
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list of allowed control statement parameters), If you 
want to pass extra parameters, the tist of them must be 
specified as a string (within single quotes). The PPAS180 
procedure does not check the vatidity of the parameters in 
the string. If you don't code this parameters no extra 
parameters are passed to the assembler. 


msg or nomsg : 


conv or 


these (optional) keys control the generation of 
informative messages by this procedure and are fully 
described In section 1.8 - “INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 


convert : 

these (optional) keys specify that the output binary 
object code file (specified by the Q parameter) is to be 
connected to the NOS/170 object text format that is 
described in the CYBER LOADER REFERENCE MANUAL. If this 
keyword is omitted the binary object code file produced is 
in the NOS/VE object text Format. 
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8e9 LINKIZ0_=_LINK_RELOCATABLE BINARIES 


LINK170 provides an easy way to use the CYBER 170 Loader. 
Although the CYBER 170 Loader is very powerful and fFflexibies it 
suffers from the disadvantage that you cantt talk to. it 
interactiveltys since it reads ahead in the control statement files 
and that means that you can only drive it via canned sequences of 
JCL. This procedure provides a simple to use interface to the 
foader which allows for most common types of linking. Parameters to 
the LINK170 procedure are : 


(optional) ftist of Files containing the relocatable 
binaries that you want LINKed. If you don*t code the f 
parameters LINK170 assumes that the relocatabies are on 
file tgo.e The f parameter may be coded as a multi vafued 
fist of sublists. Each element of the value tftist is 
either a singte names in which case it refers to the name 
of an object code file already assigned to the jobs or in 
the current user's catalogs or an element is a sublists in 
which cases the last sub element in the sublist is a user 
name in whose catalog the object code files referred to by 
the other sub elements of the sublist may be found. The 
exampie at the end of this description shoutd (with tuck) 
nake this clear. Note that files for which a user name is 
specified are returned when the tink is completed. 


(optional) name of file to receive the LINKed programe If 
you don*t the b parameters LINK170 ptaces the tinked 
program on file tgob. 


as 
se 


(optional) tist of ftibrary files from which external 
references are to be satisfied. The p parameter may be 
coded as a multi valued list of sublists. Each element of 
the value list is either a singte names in which case it 
refers to the name of an user tibrary already assigned to 
the jobs or in the current user's catalogs of an element 
is a sublists in which cases the tast sub efement in the 
sublist is a user name in whose catalog the IJlibraries 
referred to by the other sub elements of the sublist may 
be found. The example at the end of this description 
should (with tuck) make this clear. Note that ftibraries 
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oe 


fo 


xid ;: 


debug 


for which a user name is specified are returned when the 
link is completed. 


{optional} name of file to receive the map Listing from 
LINK170. If you don't code the # parameters the toader 
uses the defautt map file name (normally output). 


{optional) List Options for the LINK170 process. If you 
don't code the lo parameters the loader uses its default 
fist options. If you simply code fo without any vatues 
supplieds LINK170 sets default vaiues fozsb. If you code 
flozfuils LINK170 turns on FULL ist options (which are 
fozsbex). QOtherwises LINK170 sets whatever tist options 
you Saye 


{optional) specifies a list of Entry Points to be included 
in the header of a multiple entry point “"overtay"™. This 
list is specified as a string exactly as the list should 
appear on the NOGO toader directive (a string is used to 
allow the specification of so-cailed “speciai™ entry 
points which have a syntax unacceptable to SES). 


(optional) tist of eXtra Loader Directives. This 
parameter takes the form of a tist of character strings 
which are inserted into the control statement streams i=in 
addition to those normaily gqenerateds thus allowing you to 
supply extra directives over and above the standard ones. 


(optional) controts whether the Jinked program inctudes 
the CYBIL INTERACTIVE DEBUGger (CCOBG) or the CYBER 
INTERACTIVE ODEBUGger (CID). If you code the debug 
parameters the program will be able to be run under 
contro! of the requested debugger (by preceding a cail. to 
the program with the control statement DEBUG{ON)D). Legal 
values are CCDBG AND CID. If no vatue is givens CCDBG is 
usede NOTE: if DEBUG is specifieds the tables used by the 
debugger are placed on file ZZZZZ0T. This file must also 
be saved and made tocal {tf the absolute binary is to be 
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used at a tater time. 


or iswitib : 

these {optional) keys provide a convenience when tinking 
programs written in the CYBIL or ISWL tlanguages 
{respectively). If you are linking such a programs you 
are advised to use the appropriate one of these keys 
{hopefully obvious by their names) for the language iin 
questions since such usage causes the LINK170 procedure to 
acquire the necessary fibrary ands generate any other 
necessary loader directives associated with LINKing a 
program in the designated language. 


el or errievi : 


status 


this loptional) parameter controls the Error Level at which 


the tloader aborts without producing any absolutes. Valid 
values for the el parameter are ? 


NONE onty "terminal™ errors cause an abort. 


FATAL onty fatal errors cause an aborte 


ALL all errors (both fatal and nonfatat?) cause an abort. 
ALL is the defaylt for LINK170. 


A default value for the el parameter may be set up via the 
errlevi profile variable if you dontt wish to keep 
overriding the defauit by coding the parameter. 


: 

status is an (optional) parameter used for those cases 
where LINK170 is being used as a building block of more 
sophisticated procedures or jobs. The status parameter 
causes LINK170 to set one of the job contro! registers to 
the value zero if LINK170 successfully completeds and non 
zero if anything went wrong during the run of LINK170. 
The onty vatues that may be coded for the status parameter 
are one of Ris R2s R3 or EF. Any other vaiue coded causes 
an error message to be outputs and LINK170 aborts. 


Examples of LINK1i70 Usage 


COMPANY PRIVATE 


8-23 
COC ~ SOFTWARE ENGINEERING SERVICES 
7/30/81 
SES (Release 17) User's Handbook REV: AB 
8.0 COMPILINGs LINKINGs AND DEBUGGING 
82.9 LINK170 - LINK RELOCATABLE BINARTES 


seseflink170 b=txtforms i=mapforms ito 
* END LINK170 TXTFORM 


This example shows LINK170 used to fink aie program. The 
relocatable binaries are assumed to be on file Igos and the LINKed 
program appears on file txtform. A partial toad map is written to 
file mapfora. 


seselinki70 p=(mylibsyourtib) themap full cybclib debug 
* END LINK170 LGOBsZZZZZDT 


This exampie illustrates the use of multipte user tlibraries and 
in particular the use of the CYBIL run-time tlibrary. The 
relocatable binaries are assumed to be on file tgos the linked 
program (with CYBIL INTERACTIVE DEBUG) is written to file igob and a 
full toad map is written to file themap. Debug symbol tables are 
written to file zzzzzdt. 


seselink170 bzabss pz=(sometibs(utillibs jbfl)s e- 
eo? fz (retos oreos, jee) 
* END LINK170 ABS 


This example shows files relfo and oreos belonging to user Jjees 
being linked using ftibrary somelibs which is either local to the job 
or belongs to the current users and library utittib which belongs to 
user jbf. The linked program is written to file abs. Files retos 
oreos and utifttib are returned when the link is completeds but file 
sometib is teft tocal. 
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8210 GEICCOB_=_GEI_CYBIL_INTERACTIVE DEBUG 


GETCCDB provides an alternate way to acquire CYBIL INTERACTIVE 
DEBUG (CCDBG).} Normaltys CCDBG is acquired when necessary by the 
LINK170 procedure. If the LINK170 procedure is not to be used in 
the current sessions thoughs the necessary files must be explicitiy 
attached. There are no parameters to the GETCCDB procedure. 


Exampte of GETCCOB Usage 


sesegetccdb 
* CYBIL INTERACTIVE DEBUG AVAILABLE 
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Sell GETLIB8_ OR GETLIBS = _ ACQUIRE LIBRARY _E08_ LINKING 


GETLIB(S) acquires the CYBCLIB or CYBILIB tibrary ready for 
linking. Parameters to GETLIB(S) are 3: 


cybclib or cybitib : 
these (optional) keys inidicate which library is required 
to be made tocal. Coding the cybctfib key acquires the 
CYBIL-CC librarys while coding the cybilib key acquires the 
CYBIL-CI tibrary. 


Exampties of GETLIB(S) Usage 


sesegetiib cybclib 
* END GETLIB CYBCLIB IS LOCAL 


sesegetiibs cybiltib 
* END GETLIBS CYBILIB IS LOCAL 
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9-0 CYBER_1L380_VIRTUAL_ ENVIRONMENT CREATION AND SIMULATION 


"Simulation aintt what it's going to be* 
New Scientist 


This chapter describes the SES utilities for creating and using 
the CYBER 180 Virtual Environment on the CYBER 176. The chapter 
following describes the CYBER 180 Object Code Utility. Facilities 
described in this chapter are 3 


$IM180 run the CYBER 180 Hardware Systen Simulator. 
T0180 convert a NOS/170 text fite for use with the simulated 
NOS/VE I70 available through the SIM180 procedure. 


T0170 NOS/170 to NOS/170 INTERFACE file conversion. 


FROM180 convert a simulated NOS/VE I/0 text file to a NQ3S/170 text 
file. 


FROM170 converts NOS/170 INTERFACE format files to NGS/170 format. 
DUMP18O0 dumps the contents of a simulated NOS/VE file. 

DUMP170 dumps the contents of a NOS/170 INTERFACE format file. 
GENCPF link CYBER 180 binaries and generate a Checkpoint File. 
VELINK link CYBER 180 binaries and produce Segment Files. 

VEGEN generate a CYBER 180 Checkpoint File from Segment Files. 
GETLIB(S)get CYBIL run time library focal to job. 
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GETDSI make HCS IOU Deadstart tape generator tocal to job. 


GETLDB make HCS NOS Environment Interface Loader !tocai to job. 
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Del SIML8O_ =_RUN_THE CYBER_180 HARDWARE SYSTEM SIMULATOR 


SIM180 runs the CYBER 180 Hardware System Simulator (often 
referred to as the HSS). The hardware system that is simulated 
consists of the following components ? 


1. CPU 

2e Central Memory (16 Megabytes) 

32 10(10) Peripheral Processors (PPs) 

4. 1210) 1/70 Channels 

5.2 2 7154 disk controllers sharing 4 844-4x disk storage 
units. 

64 2 7155-1 disk controllers sharing 2 844-4x and 2 885—-1x 
disk storage units. 

72 2 7155-14 disk controllers sharing 2 844-4xs 2 885—-1x 
and 2 885-42 disk storage units. 


SIM180 sets up the total system simulated environment and gives 
control to the CYBER 180 simulator. At this points the user may 
enter any valid simulator command (refer to document ARH1729 - 
"CYBER 180 SIMULATOR ERS” for command descriptions). Simulator 
commands oerovide the user with control over the simulated 
environment which includes the following capabilities : 


1. CPU and PP memory toading 

22 Interpretive CPU and PP instruction execution 
32 CPU and PP breakpoint 

4. CPU and PP trace 

5e Display and change Central and PP memories 

6¢ Dump Centrat and PP memories to a specified file 
7» Display and change CPU and PP registers 

8. Checkpoint / Restart 

9. On/off CPU and PP simulation 
10. CPU keypoint 
11. CPU program performance monitoring 


The CYBER 180 simutator is intended primarity for interactive use 
(focal mode) but may be readily used in batch. An example of batch 
submission of a Simulator run is given below. Parameters to $IM18C 
are : 


restart orrs : 
(optional) name of a checkpoint file from which to restart 
sinulation. The checkpoint file may be one previously 
created by GENCPF (GENerate (CheckPoint Eile)» VEGEN 
(Virtual Environment GENerator),s or via the simulator 
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cf : 


4180 or 


0180 or 


$eSe 


CHECKPOINT command. If you don't code the restart 
parameters a complete simutated system is created. 


(optional) name of a command file which is to be processed 
immediately upon activation of the simulator. The command 
file consists of one or more valid simulator commandis). 
This parameter is required when running in batch. 


2 
i: 


(optional) name of file containing Input for the special. 


Simutator CPU I/D instruction (op code FF(16)). If youfre 
running SIM180 interactively and don't code the i180 
parameters SIM180 takes its input from a file assigned to 
your terminal. If you run SIM180 in batch and use the CPU 
1/0 instruction for inputs you must supply aie file 
containing the input. 


0 3 

(optional) name of File to receive output from the special 
simulator CPU I/0 instruction (op code FF{(16)). If you're 
running SIM180 interactively and don't code the 0180 
parameters SIM180 sends output to a file assigned to your 
terminal. If you run SIM180 in batchs you must supply a 
file to receive the outputs otherwise the output is lost. 


Examples of SIM180 Usage 


siml80 


** IT SM 6052: CYBER 180 SIMULATOR VER 664 LEV 126 (MIGDS REV $) 


This exampte shows SIML80O0 used interactivelys, to create a new 


simulated 


system environment. The user may enter any simulator 


command once the simufator banner is displayed. 


$ese 


sim180 rs=checkl cfzerrata 


** I SM 6052: CYBER 180 SIMULATOR VER 6464 LEV 126 (MIGDS REV $) 


This exampie shows SIM180 used to resume simulation from a 
checkpoint file. The command file errata is processed before 
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requesting additional simulator commands from the user. 


sesesiml80 checkx izindata ozoutdata 
** I SM 6052: CYBER 180 SIMULATOR VER 624 LEV 126 (MIGDS REV S$) 


This example shows SIM180 used interactively» to resume 
simulation from the checkpoint file checkx. The special simulator 
CPU I/0 instructions when encountered during CPU instruction 
simulations is to read input from file indata and is to write output 
to file outdata. 


sesedo batchns filezsimcfsecece 
eo? cs#(*sesesiml80 postdss cfzsimcefs o=progout!®sececes 
eet *savessesiog!) 
1525%.-28. SUBMIT COMPLETE. JOBNAME IS AAAQCBN 
* J08 DO SUBMITTED 


This example shows SIM180 submitted for batch running via the SES 
DO procedure. Simulation wiil resume from the checkpoint file 
postds» the simulator commands in the file simcf are processeds and 
any output from the special simuftator CPU I/0 instruction is 
directed to file progout. Refer to the description of the SES DO 
procedure in the "Miscellaneous Useful Goodies" section for an 
expfanation of using 00 to submit multipie control statements to 
batche 


COMPANY PRIVATE 


ae we 


9-6 
CDC - SOFTWARE ENGINEERING SERVICES 
7/30/81 
9.0 CYBER 180 VIRTUAL ENVIRONMENT CREATION AND SIMULATION 
9.2 T0180 - NOS/170 TO SIMULATED NOS/VE FILE CONVERSION 


DO OED OF PD PO POE O8 FE FO 8 RE FE PO PE RE FE OE OE PE PE PE BO 90 OE PE OE OE OED PE BE OE EE PE HE PE OE PE FE PO PE AO PO 88 PE 18 PO OO PE PE F808 08 0 PE 78 28 PO 08 8 On 8 


962 I0180_-_NOS/170_T9 SIMULATED NOS/VE_EILE_CONVERSLON 


T0180 converts a NOS/170 file containing character data to 
SIMULATED NOS/VE fite format. Onty character data can be 
converted. Parameters of T0180 are: 


ior f 
The Input or File parameter specifies the NQO$/170 format 
file to be converted. 


The (optional) Output parameter specifies the SIMULATED 
NOS/VE format file to recelve the converted data. If this 
parameter is omitted then the output and input file names 
are the same. 


es612 or cs64 
These {(optional) keys indicate whether the NQS/170 format 
File is upper/lower case ascii (cs612) or whether it is a 
64 character set ascii or display code file (cs64). If no 
keyword is given then cs612 is used. 
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923 101Z0_=_NdS/170_TO_uas Z1Z7Q_INTEREACE_EILE CONVERSION 


TO170 converts a NOS8/170 file containing character data to the 
NOS/170 INTERFACE format of simulated NOS/VE I/0. It is similar to 
TO180 except that the output file content is different. Parameters 
to T0170 are : 


ior f 3 
Name of the Input Eile to be converted, 


{optional) name of file to receive the Qutput, that Is» the. 
NOS/170 INTERFACE format data. If you don't code the o 
parameters, the output appears on the file specified by the 
i parameter. 


cs612 or cs64 ; 
these (optional) keys specify the character set of the 
input file. T0170 assumes the input fite is in ecs612 
character set. 
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9e% EROMI80_-_ SIMULATED _NOS/VE_TQ_NOS2170_EILE_ CONVERSION 


FROM180 converts a file in SIMULATED NOS/VE format containing 
character data to NOS/170 format. Conversion stops whenever an 
error is found on the SIMULATED NOS/VE format file. Such errors 
inciude invalid record headers on the file and non-ASCII data in the 
records. The NOS/170 format file may be printed with an SES.PRINT 
commands or input to any other normal NOS/170 programe. Parameters 
of FROM1L80O are: 


i or f 
The Input or Fite parameter specifies the source datas 
SIMULATED NOS/VE format file. 


The (optional) Qutput parameter specifies the N0S/176 
format file. If this parameter is omitted then Input and 
Dutput File names are the same. 


cs612 or cs6%& 
These keywords indicate the character set of the outputs 
NOS/170 format file. Upper/ilower case ASCII is indicated 
by the keyword es612 and the keyword cs64 indicated a 64 
character set ASCII or display code. If this parameter is 
omitted then cs612 is used. 
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925 EROMLZ2_=_NOS/170_INTEREACE TO _NOSZL70_EILE_ CONVERSION 


FROM170 converts NOS/170 INTERFACE format file containing 
character set data to NOS/170 format. Conversion stops when = an 
error is found in the NOS/170 INTERFACE format file. Such errors 
inciude invalid record headers in the files and non ASCII data =in 
the records. The NOS/170 file may be printed via the SES PRINT 
procedures or input to any other normai NOS/170 program. Parameters 
to FROM170 are : 


ior f 3: 
name of Input Eile to be converted. 


(optional) name of file to receive the Qutput of FROM170. 
If you don't code the o parameters the output appears on 
the file specified by the i parameter. 


cs612 or cs64& 3: 
these toptional) keys specify the character set of the 
output files and correspond to the same parameters on the 
FROM180 procedures 
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9o6 DUMP180_=-_ SIMULATED NOS/VE_EILE Dume 


DUMP180 dumps the contents of a simulated NOS/VE file. It is 
Simiftar to HEXOMP except that it checks the records and data 
structure of the file and diagnoses errors which prevent FROM180 
from converting the file. Parameters to DUMP180 are 3 


ior f 3 
name of the fite to be dumped. 


{optional) name of file to receive the dump. If you dontt 
code the oo parameters the dump output appears on file 
output. 


es612 or cs64 ? 
these foptional) keys specify the character set of the 
output files as in the FROM180 procedure. 


fw : 
(optional) Eirst Word of the file to dump. The default is 
to start at word 0. 


(optional) Last word of the file to dump.» The defautt is 
to dump up to end of information (EDI). 
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9o7 DUMPIZO_=_NOSZ170_INTEREACE EILE DUMP 


DUMP170 dumps the contents of a NOS/170 INTERFACE format file. 
It is similar to DUMP180s» except that DUMP170 also checks the record 
and data structure of the input file and diagnoses errors which 
prevent FROM170 from converting the filee Parameters to DUMP170 are 


s 
2» 


ior f 3 
name of the Input Eile to be dumped, 


(optional) name of Qutput file to receive the dump. If you 
dontt code the o parameters the output appears on file 
output. 


es612 or ¢cs64& : 
these tloptional) keys specify the character set of the 
output fille. ODUMP170 assumes the cs612 character set. 


{optional) Eirst yWord from which to start dumping. If you 
don’t code the fw parameters, the dump starts from word 0. 


{optional) Last Word to be dumped. If you don't code the 
iw parameters, the dump goes to end of information (EOI). 
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9o8 GENCPE =_GENERATE_A_ CHECKPOINT _EILE_ (CPE) 


GENCPF executes the SES Virtual Environment Linker and the SES 
Virtual Environment Generator to produce a Checkpoint File (CPF) 
which can be toaded and executed on the CYBER 180 Hardware System 
Simutator. The user must provide a file containing CYBER 180 object 
texts and can optionaily provide a Linker Parameter File (LPF)» a 
set of Monitor Segment filess and/or a Virtual Environment Generator 
DIRective file. The mf file contains the map produced by the 
Virtual Environment Linker and additional information produced by 
the Virtual Environment Generator. 


Note: most of the foltowing parameters aren't needed by the 
"general public™ (examples show general usage). 


Parameters to GENCPF are: 


oft 2: (Filename(s)s optional) 
Object _File_list - tist of up to 10 names of files 
containing CYBER 180 object text {ver 1.20). This 
parameter does not have a default. 


ifi : (Filename({s)s optional) 
Library _File List - tist of up to 10 names of Library 
files containing CYBER 180 object text. This oarameter 
does not have a default. 


pep = (String(31).s optional) 
Primary _Entry_Point - This parameter specifies the entry 
point at which to start execution. The default is to 
start execution at the first Transfer symboi encountered. 


ns 3: (String{4)s optional) 
Name _Seed - This parameter specifies the "name seed" for 
the Virtual Environment Linker Segment files. The default 
for this parameter is segm. The vatue of this parameter 
overrides any Linker Parameter File specification of this 
Field. 


mf : (Fitenames optional) 
Map _File - This parameter specifies the name of the map 
file. The default for this parameter is linkmap. 
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mo ; 


rewind 


ipf : 


cpf :; 


cybilib 


this (optional) parameter determines the tinker Map 
Qetions. mo determines the amount of information output on 
the tinker mape Any value coded for mo overrides the 


default options chosen by the linker parameter file (LPF). 
The value of the mo parameter is gone of the following 
characters : 


N no map information; diagnostics are output. 

S Section allocations for every section of every input 
object module. 

E section allocations pilus Entry point names and address 
assignments. 

M section allocations and entry points plus output 
segment and common block aifocations (this iast option 
is in fact a full linker map). 


or norew 3 

these (optional) keys determine whether to REWIND the 
finker map file before writing it. The default action is 
to rewind the map file. The key coded overrides any tinker 
parameter file specifications. 


{optional) name of Linker _ Parameter File containing Linker 
parameters that affect the fink process. If you don*t code 
the tpf parameters, default values are applied as in the 
description of the LPF. 


(Filenames ootional) 
Checkpoint_File - This parameter specifies the name of the 
file containing the output From the Virtual Environment 
Generator. The default is cpfite. The vatue of this 
parameter overrides any Linker Parameter File 
specification of this field. 


: (Keywords optional) 

If you code the {optional) keys GENCPF uses CYBILIB to 
satisfy externals during the Linking process. GENCPF 
ACQUIRE's CYBILIB from SES and adds it to the 
Library _File_List. The default is not to use CYBILIB as 
part of the Link. 
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dir or idrdir or d 2 (Filenames optional) 


mtrns or 


The folttow 
CYBIL» gen 


Directives - This parameter specifies the name of a file 
containing directives to the VE Generator. The default is 
a file containing default directives. 


mas 2 (String(4)» optional) 

Monitor Name Seed - This parameter specifies the "name 
seed” of the Virtual Environment Linker Segment files that 
contain the Monitor code. This parameter is provided so 
users can have their own Monitor program. The defauit for 
this parameter is mtrx. The procedure checks the ltocal 
filess the tocal PF catalogs and then the SES catalog to 
get the files. 


Exampties of GENCPF Usage 


ing example shows how to compile a test program written in 
erate a VE Files and run it on the Simulator. 


sesecybil ci iztestprg txtestist b=testigo 


$@se9 
Se@SeS 
? run 
? bye 


The fas 


The ne 
files of C 


$eseg 


encof offztestigo cpfztestepf cybilib 
im180O restartztestcof 


t two lines were Simulator commands. 


xt example shows how to generate a CPF from several input 
YBER 180 object text. 


encef oft=(mytgolsmyigo2) cpf=mycpf cybilib 
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9o9 VELINK =_EXECUTE THE VIRTUAL _ENVIRONMENT_LINKER 


VELINK executes the Virtual Environment Linkers which links data 
from CYBER 180 object files/tibraries and produces a map file and a 
set of SEGMent files. VELINK is set up so that users can specify 
their own Linker Parameter File (LPF) containing Virtual Environment 
Linker variables that contro! the linkage. For more information on 
this» refer to the SES Virtual Environment Linker ERS (ARH2816). 


Note: VELINK is generally used only in special casess where 
GENCPF is inadequate. 


Parameters to VELINK are: 


ofi 3: (Filename(s)s optional) | 
Object_File_List - fist of up to 10 names of files 
containing CYBER 180 object text (ver 1.0). This 
parameter does not have a default. 


tft 2 (Filename(s)»s optional) 
Library _Fite_List - list of up to 10 names of Library 
files containing CYBER 180 object text. This parameter 
does not have a default. 


pep : (String(31)» optional) 
Primary_Entry_Point - This parameter specifies the entry 
point at which to start execution. The default is to 
start execution at the first Transfer symbol encountered. 


ns 3 (String(4)»s optional) 
Name_Seed. - This parameter specifies the "name seed" for 
the Virtual Environment Linker Segment files. The default 
for this parameter is segm. The value of this parameter 
overrides any Linker Parameter File specification of this 
field. 


af : (Filenames optional) 
Map_File - This parameter specifies the name of the map 
file. The default for this parameter is tinkmap. The 
value of this parameter overrides any Linker Parameter 
File specification of this field. 
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mo : 


renind 


ipf : 


cybitib 


In the 


this {optional) parameter determines the tinker Map 
Qptions.~ mo determines the amount of information output on 
the linker map. Any value coded for mo overrides the 


default options chosen by the tinker parameter file {LPF}. 
The vatue of the mo parameter is ane of the following 
characters ? 


N no map information; diagnostics are output. 

§ Section allocations for every section of every input 
object module. 

E section allocations plus Entry point names and address 
assignments. 

M section alfocations and entry points ptus output 
segment and common block allocations (this tast option 
is in fact a full linker map). 


or norew 3: 

these (optional) keys determine whether to REWIND the 
linker map file before writing it. The default action is 
to rewind the map file. The key coded overrides any linker | 
parameter file specifications. 


(optional) name of Linker Parameter _File containing Linker 
parameters that affect the link process. If you don't code 
the tpf parameters default vatues are applied as in the 
description of the LPF. 


3 (Keywords optional) 

If you code the (optional) keys VELINK uses CYBILIB to 
satisfy externais during the tinking process. VELINK 
ACQUIRE'%s CYBILIB from SES . and add it to the 
Library_File List. The default is not to use CYBILIB as 
part of the Link. : 


Example of VELINK Usage 


following example the Linker is passed a Linker Parameter 


File. Object files york and hunt are ftinked using racelib as an 
object tibrary. 
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sesevelink offt=(yorkshunt) tfiemyfib ipf=myipf 
* END VELINK 
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9210 VEGEN_=_EXECUTE THE SES VIRTUAL ENVIRONMENT GENERATOR 


VEGEN executes the SES Virtual Environment Generator to produce a 
Checkpoint File (CPF) which can be loaded and executed on the CYBER 
180 Hardware System Simulator. The input to the Virtual Environment 
Generator is the set of Segment files containing the users programs 
and a default set of segment files that contain a simple monitor 
programe The monitor program contains code that sets up the 
exchange packagess stack areas» and atso provides a primitive 
Monitor and Trap Handler routiness and a Termination routine. For 
more information on the Virtual Environment Generators refer to the 
" SES Virtual Environment Generator ERS" (ARH2591). 


Note: VEGEN is generatly used only in special cases» where GENCPF 
is inadequate. 


Parameters to VEGEN are: 


dir or tdrdir or di (Fitenames optional) 
Directives - This parameter specifies the name of a file 
containing directives to the VE Generator. The default is 
a file containing default directives. 


ns 3 (String(4)s. optional) 
Name Seed - This parameter specifies the “name seed" of 
the Virtual Environment Linker Segment files. The default 
for this parameter is segm. 


mtrns or mnas : (String(4).5 optional) 

Monitor Name _Seed - This parameter specifies the "name 
seed" of the Virtual Environment Linker Segment files that 
contain the Monitor code. This parameter is provided so 
users can have their own Monitor program. The default for 
this parameter is mtrx. VEGEN checks the local filess the 
current user's catalogs and then the SES catatog to get 
the files. 


epf : {Filenames optional) 
Checkpoint File - This parameter specifies the name of the 
file containing the output from the Virtual Environment 
Generator. The default is cpfite. 
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mf : {Filenamey optional) 
Map File - This parameter specifies the name of the file 
on which to write the map information. The defautt is 
linkmap. 


Exampte of VEGEN Usage 


In the following examples the Generator is passed a directive files 
a set of segment files containing the test programs a set of monitor 
filess and produces a CPF and Map file. 


sesevegen dir=mydir nszttest* mtrns=*ntrxt cpfemycpof mf=mymap 
* END VEGEN 
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Fell GETLIG_QR_GEILIBS _=_ACQUIRE LIBRARY COR LINKING 


GETLIB(S) acquires the CYBCLIB or CYBILIB tibdrary ready for 
linking. Parameters to GETLIB(S) are 3: 


cybclib or cybilib ; 
these (optional) keys inidicate which tibrary is required 
to be made tocal. Coding the cybctib key acquires the 
CYBIL-CC Jlibrarys while coding the cybilib key acquires the 
CYBIL-CI tibrary. . 


Examples of GETLIB(S) Usage 


sesegetiib cybclib 
* END GETLIB CYBCLIB IS LOCAL 


sesegetiibs cybilib 
* END GETLIBS CYBILIB IS LOCAL 
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9012 GETDSI_=_ ACQUIRE BINARY_EOR_ DEADSTARI_TAPE. GENERATOR 


GETOSI acquires the absolute binary to run the HCS I0U deadstart 
tape generator. There are no parameters. 


Exampie of GETDSI Usage 


sesegetdsi 
* END GETDSI VGENOSI IS LOCAL 
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9013 GETLDB_-_ACQUIRE BINARY EOR_ENVIRe_ INTs LOADER 


GETLDB acquires the absolute binary to run the HCS Environment 


Interface ltoader. There are no parameters. 


Example of GETLDB Usage 


sesegetidd 
* END GETLDB VGENLDB IS LOCAL 
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10.0 SOURCE CODE UTILITY _ON_NQS_170 


SES provides a series of orocedures for access to the NGS 170 
prototype implementation of the Source Code Utility. A detailed 
description of SCU commands is availabie in the ERS for Source Code 
Utility {NOS 170 version) ARH1766. The procedures currently 
available in this category are: 


SCU Acquire the executable binary for SCU. 


SOLO Run the SCU editor in stand alone mode. 


SCUCOMP Generate an SCU modification for a deck. 
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10.1 {CU_=_ ACQUIRE EXECUTABLE BINARY EFOR_SCY 


SCU acquires the executable binary for the Source Code Utility 
and copies it to a tocal file named SCU.s. #$In response to calling 
this procedure the user may be sent a short message warning him that 
a change has been introduced and that there is additional 
information available through the TOOLREP facility. There are no 
parameters for the SCU procedure. 


The libraries CYBCCMN and CYBICMN which contain deciarations for 


interfaces supported by the SES group may be accessed in the form of 
SCU source tibraries through the use of the GETCOMN procedure. 
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10.2 SOLO_.-_STAND_ALONE_SCU_EDITOR Ws 


SOLO is a stand alone version of the SCU editors that can be iyce 
to edit any text file. A delay will be encountered when enteréng 
and exiting this editor because a temporary tibrary is created-on 
entry from which the text file is extracted on exit. Parameters to 
SOLO are : . 


base or ba 3 a ) 
(optional) name of text file to be edited. If you @gonitt 
code the base parameter, SOLO uses ae tocat file named 
bases : - 


resuit or r 3 . 
(optional) name of file to receive the result of the 
editing session (SOLO doesn't» by defaults write the edited 
file back over the text input File specified by the base 
parameter). If you don't code the result parameters SOLO 
writes the result on a tocal file named result. . 


input or i : 
(optional) name of input file from which SOLO reads 
commands. If you don't code the input parameters commands 
are read from input. 


fist or { 3 
{optional) name of file on which the editor disptays are 
written. If you don't code the fist parameters SOLO writes 
its displays to file output. 
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10.3 SCUCOMP =_ GENERATE _SCU_CORRECTION SET 


SCUCOMP compares an “oid™ version of an SCU deck obtained from 
an SCU source ftibrary) with a "new" version of the same deck 
(obtained from a “source™ File). The “source” file must have 
neither line identifiers nor deck directives in ite The output of 
SCUCOMP is ae fite of SCU EDITor commands that transform the "old" 
version of the deck into the "new" version. 


You can setect a character to be used as the vatue of the UNTIL 
parameter on SCU EDITor INSERT and REPLACE commands. The default 
character is the percent signe If any tines of insertion or 
replacement text end in the "text delimiter" characters they are 
followed on the edit commands file with a tine that indicates the 
probiems and the NOS job control register EF is set to a non-zero 
value; otherwise EF is set to zeroe Parameters to SCUCOMP are : 


name or na : : 
NAME of an SCU deck against which the correction set are 
generated. 


source or s 3: ; 
‘name of a source file containing a modified version of the 
deck. 


name of a file to which SCU editor commands are to be 
written. 


base or ba ;: 

(optional) name of an SCU source library containing the 
"unmodified" version of the SCU deck with which the source 
file are compared. If you don't code this parameters 
SCUCOMP attempts to access a file named base. 


(optional) User Name in whose catalog the source tibrary 
specified by base is to be found. 


{optional) singite character value which defines the 
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Ierminating Delimiter to be used on text insertion commands 
generated by SCUCOMP. The vatue of td may be given as any 
Single characters or as a positive integer in the range 
lewl27. If you don't code the td parameters SCUCOMP uses 
the percent sign 2% as the default character. 


is or ignorts 3 
These (optional) keys specify whether or not to JGNQORe 
Leading Spaces on tines being compared. The default 
action is to recognise feading spaces (the Is option). If 
you code the ignorts key SCUCOMP ignores leading spaces on 
text lines. 


Exampfe of SCUCOMP Usage 


sesescucomp ‘scm$editor_help_command' formed .-. 
ec=modform bazsi0619 


This exampie of SCUCOMP compares formatted source statements on 
file FORMED with the SCU deck SCMSEDITOR_HELP_COMMAND from the 
source tibrary on file $L0619 to build an SCU modification for the 
deck on file MODFORM. In this case lines differing by ieading 
spaces were recognised as changed. 
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11.0 CYBER_1L80_QBJECT CODE UTILITIES 


The Gbhject Code Utitities are a collection of commands which used 
to create and update libraries» modify certain aspects of individual 
modutess and fist various types of information for each module. The 
utilities accept as input CYBER 180 object modules in €180 loader 
text format V1.0 generated by CYBER 180 compilers and assemblers 
executing on CYBER 170. Consult the ERS for 180 Object Code 
Utilities (ARH2922) for more details. Here is a brief summary of 
the Gbhject Code Utility commands. The full descriptions fottow. 


COM Change Object Module. Changes characteristics of a modute 
in an object tibrary. 


DEOM DElete Qbject Modules) from an object tibrary. 

DIOM Risplay Qbject Module(s) information. 

GOL Generate Qbject Library. Generates or updates an object 
tibrary. 

GOF Generate Qbject Eile. GOF is similar to GOL» except that 


GOF produces a file which is not a tibrary. 
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Parameter Naming Convention for OQbiect Code Utilities 


This section introduces the parameter naming convention common to 


most of the procedures 


file or tibrary 


module 


upon 


fisting 


in the CYBER 180 ODbject Code Utilities. 


name of the object tibrary (or file) on 
which the object modules reside. 


name of a module or range of modules 


name of new library (or file) for those 
procedures which update a tibrary (or 
file). 


name of file to receive tisting 


- information. 
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PROEILE Vaciabies for OQbhiect Code Utilities 


The variables described below may be dectared in your PROFILE in 
order to establish default information for the parameters of the 
CYBER 180 Object Code Utilities procedures. 


fokmode used by all of the procedures that update tlibrariess to 
determine the default interftock action. tlokmode may be set 
to one of "LOCK! or "*NOLOCK*®. See also the sections below 
on updating tibrartes and interlocking. 


intriok used by all of the procedures that update tibraries to 
specify the interlock file to be used during the update 
process. The defautt name for this file is intrlok. 
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Interlock. Process. for Unodating_ a Library 


When updating a tibrary you can interlock the update sa that onty 
one user at a time can update the tibrary. Those procedures that 
update a library are set up so that if the tibrary to be updated is 
in another user's catalogs the ftibrary is interlocked by default. 
You can override default actions by defining a tokmode variable in 
your profiles or by coding a tock or notock key on the procedures as 
shown in the diagram on the next page. 


Intertocking of a library is done via an interlock file. Such a 
File must be a DIRECT access file in the same user's catalog as the 
library being updated. Naturattiy the interlock file must be a 
PUBLICs WRITE MODE file if other users are likely to be using it. 
The default name used by the SES CYBER 180 Gbject Code Utilities and 
library management procedures for the tock file is intertok. You 
can have an interlock file of any name by defining the intriok 
profile variables or by coding a file name as a vatue for the tock 
parameter on the appropriate procedures. 


COMPANY PRIVATE 


11-5 


COC ~ SOFTWARE ENGINEERING SERVICES 


SES (Release 17) 


7/3078 


User's Handbook REV: AB 


PO PO FE PO OG 10 78 TE PE PO FE RE PG FO OO 8 FEO PE FO PE F8 F8 OB 08 Ft PE FO PE OE RE DE PA OE 98 FO PE OE DE PETA TAPE 00 08 PE D8 PE 98 PE 1G PO OE PE FE PE 8 F878 18 78 ON 18 88 88 18 0 Ee 


11.0 CYBER 180 OBJECT CODE UTILITIES 


‘Coded Qo ; 
Procedure ; 


Nothing Coded in Profile : 


ihescy or base is Ponkes foaaediiace of hin tenes 
FoxaoCge proriry variable or other conditions. 
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Qe Libracy 
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locked 3 
nolock } 
3 
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11-1 COM_=_CHANGE_ OBJECT MODULE 


COM Changes an Qbject Modute in an object tibrary. Various 
characteristics of the module may be changeds such as entry point 
names which may be substituted or removeds gated entry points may be 
designated or removeds and commentary may be changede Parameter to 
COM are 3 


file or fF or tibrary or tib : 

name of file Cor tlibrary) containing the module to be 
changeds plus an (optional) user name specifying the 
catalog where the file (or Jtibrary) resides if it is not in 
the current user's catalog. The specified file may or may 
not be a librarys but if the keyword used is ttib or tibrary 
» it must be a library. Whether the upon file is a library 
is determined by the format of this input file. If you 
code a file name and auser names they must appear as 4a 
lists the first etement of which is the name of the files 
and the second element the name of the user in whose 
catalog the file resides» for example : fFe(dates paim) to 
get file date from the catalog of user paim. 


module or mo ? 
name of the module in the library to be changed, 


{optional) name which replaces the name of the specified 
module. 


{optional) entry point pair(s) whose names are to be 
substituted. The pairs are of the form (<old entry 
point>s<new entry point>) where <old entry point>d is 
replaced by new entry point>d. 


omit or o 3: 
foptional) entry poitntis) whose definitions are to be 
removed from the output module. 


gate or g : 
(optional) entry pointis) that are to be gated in the 
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oe 


ng 


comment 


upon or 


lock or 


output module. Gated entry points can be entered from any 
ring within the files call bracket. 


(optional) entry point(s) for which the gated attribute is 
to be removed. 


{optional) entry point at which execution is to begin 
(transfer symbo!). 


or co 3 
{optionajs) contents of the commentary field in the module 
header. 


up 3 

name of file to receive the updated file (or tibrary)»s plus 
an (optional) user name in whose catalog the file (or 
library) residess if the file (or library) is not in the 
current user's catalog. Whether the upon file is a tibrary 
is determined by the format of the input File. If you code 
a file name and a user names they must be coded as a lists 
the first etement of which is the name of the files and the 
second element the user name in whose catalog the file 
resides. If you just code the file name and no user names 
the upon file is placed in the catatog of the current 
user. If the user name refers to another user's catalogs 
the upon file must already exist in that user's catatog. 


nolock : 

these (optional) parameters determine whether the library 
update process is interfocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the interlock file. Interlocking is the default 
action when the library being updated is in another user's 
catalog. If you don't code either of the tock or notock 
Keys» intertocking is controtted by the ltokmode profiie 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the ltokmode 
profile variable and the ftock and notock parameters. If 
you dontt code a Ffitename for the tock parameters the 
contents of profile variable intrtlok is used as the 
interlock filename; if there*s no such profile variables 
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the name intriok is used as the tock filename. The 
interlock file must be in the same catalog as the library 
being updated. If the interfock file cannot be founds the 
procedure aborts. 


msg or nomsg : . 
these {optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". | 
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Examples of COM Usage 


sesecom libraryztibl module=zmodx nn=mody uponzlib2 
* MODULE MODX CHANGED ON FILE LIB2 


This command creates a new tibrarys ttib2 which is identica!t to 
library tibl except that the name of modx is changed to mody. 


sesecom fitel modx sz({eplsneweplislep2snewep2)) ups(file2swrb) 
* LOCKING FILE2 VIA INTRLOK 

* FILE2 LOCKED 

* FILE2 UNLBDCKED 

* MODULE MODX CHANGED ON FILE FILE2 


This command creates a new file file2 (may be library) identical 
to filel except that entry point name newepl replaces epl and newep2 
replaces ep2. The destin ation files file2 is given with the user 
name wrbs so the automatic interlocking process takes place during 
the update of file2. 


sesecom libl mozsmodulex ozentl gzent2 ngzent3 prozent4 ee 
ee? coz*cpu migds review up=tib2 
* MODULE MODULEX CHANGED ON FILE LIB2 


This command creates a new library tib2 identical to tibl except 
that entry points in module modulex are modified as follows : entl 
is removed; ent2 is set to gated; ent3 is set to not gated; the 
trans symbot is changed to ent4; and the commentary field is changed 
as shown. 
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11.2 DEQM_=_DELETE OBJECT MOQDULECS) 


DEOM DEtetes Qbject Modulels) or ranges of object modules from an 
object tibrary. Parameters to DEOM are 3 


file or f or tibrary or lib : 

name of the file (or library) from which module (s) or 
module subrange({s) are to be deteteds plus an foptional) 
user name in whose catalog the file or fibrary resides if 
it isntt in the current user's catalog. The specified file 
may or may not be a librarys but if the keyword used is 1tib 
or ftibrarys it must be a tibrary. Whether the upon file is 
a library is determined by the format of this input file. 
If you code a file name and a user names they must appear 
as a lists the first element of which is the name of the 
files j§and the second element the name of the user in whose 
catalog the file residess for example : fz{(coconuts palm) 
to get file coconut from the catalog of user palm. 


modufe or mo : 
modufe({s) or module subrange(s) to be deteted from the 
File. If a specified module is not on the files aie fatal 
error is issued. 


upon or up 3: 

name of the filte for tibrary) on which the remaining 
modules are writtens pius an (optional) user name in whose 
catalog the updated fite (or library) is to be placeds if 
it is not in the current user's catalog. Whether the upon 
file is a tibrary is determined by the format of the input 
file. If you code a file name and a user names they must 
be coded as a lists the first element of which is the name 
of the files and the second element the user name in whose 
catalog the file resides. If you just code the file name 
and no user names the upon file is placed in the catalog of 
the current user. If the user name refers to another 
user's catalogs the upon file gust already exist in that 
user's catalog. 


flock or notock ; 
these (optional) parameters determine whether the library 
update process is interlocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
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name of the interfock file. Interlocking is the default 
action when the library being updated is in another user's 
catalog. If you don't code either of the tock or nolock 
keys» interlocking is controtted by the ftokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profite variable and the tack and nolock parameters. If 
you don't code ae filename for the tock parameters the 
contents of profile variable intriok is used asthe 
interlock filename; if therets no such profile variables 
the name intrtok is used as the tock filename. The 
interlock file must be in the same catalog as the library 
being updated. If the intertlock file cannot be founds the 
procedure aborts. 


fisting or fist : ; 
(optional) name of listing file on which the names of the 
modules on the new Itbrary are tisted in the order iin 
which they occur as welt as the file from which they 
came. If you don't code the fist parameters no “Listing” 
output is produced. 


msg or nomsg 3; . 
these (optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 — “INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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Examples of DEOM Usage 


sesedeom tibrary=tibl modutezmodx upon=)ib2 
* MODULES DELETED ON FILE LIB2 


This command creates a Jibrary tib2 identical to §ibl except that 
modufe modx is deleted. 


sesedeom filez(filels userl) moxzx(moda.emodbsmodc) upzfite2 
* MODULES DELETED ON FILE FILE2 


This command creates a file fite2 (is tibrary if filel is 
tibrary) identical to filel except that modules between moda and 
modb inclusive and modc are deleted. The file (or Jfibrary) fitel is 
being obtained from the catalog of userl. 
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11.3 DIOM.-_DISPLAY OBJECT MODULE INFORMATION 


DIOM QIisplays various pieces of information about Qbject 
Module(s) in an object tJibrary. The format of the tist File 
produced is described in the object code utilities ERS (ARH2922). 
Parameters to DIOM are : 


file or f or tibrary or bib ; 
name of file for tibrary) whose contents are to be 
displayeds pilus an (optional) user name in whose catalog 
the file lor tibrary) is to be founds if it is not in the 
current user's catatog. The specified file may or may not 
be a librarys but if the keyword used is tib or tibrarys it 
must be a tibrary. If a fiie (or tibrary) name and a user 
name is codeds they must appear as a lists for 
example : tib=(offthes wali) to get fibrary offthe from the 
catalog of user wall. 


module or mo ; 
Coptional) moduletis) or module subrange(s) about which 
information is to be displayed. If a subrange is 
specifieds ali modules in the subrange are displayed. 
Dmisston causes alf modules in the file or library to be 
displayed. 


fisting or tist : 
(optional) name of file on which the display information 
is to be written. Omission causes the information to be 
written to the job output File. 


on 3: 
(optional) tevel of information to be displayed. Only the 
options selected are in effect. Valid specifications are: 


time and date module was created 

entry point definitions of the module 

modute header information 

external references made by the module 

al! information printed by Ds Es H and X (default) 


ee a 
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Examples of DIOM Usage 


sesediom tibraryztibl module=zmodx tistztistx onza 
* MODULES FROM FILE LIB1 DISPLAYED 


This command fists atl information about module modx of tlibrary 
tibl on file tistx. 


sesediom filez(filexsiosery) moz(moda..modbsmodc) onz(dshsx) 
* MODULES FROM FILE FILEX DISPLAYED 


This command lists date and time created» module header 
informations and external references about modules moda to modb 
inclusive and mode of filex (may be fibrary) on file output 
(default). The file filex is acquired from the catalog of user 
fosery. 
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11.4 GOL_-_ GENERATE OBJECT LIBRARY 


GOL Generates an Qbject Librarys or updates an existing object 
library. Aliso» several files can be combined into one. GOL 
requires that there be an input File specified either by the file 
parameters or base parameter. 


The adds replaces and combine parameters» specify exactiy which 
modules from the filets) specified by the file parameter to inctude 
on the new Jibrarys while the after and before parameters contro! 
the position of the new modulese Parameters to GOL are 


file or f or JVibrary or tib : 

(optional) list of filename-username pairs describing files 
{or tibraries) from which object modules specified by the 
following three parameters are to be obtained for the new 
fibrarye The specified filets) may or may net be 
fibrary(s)» but if the keyword used is tib or tibrarys they 
must be tibrary(s). Each element in the fist of file (or 
library) names can either be a single file for tibrary) 
names or the element can itself be a list of two elements» 
the first is the file (lor library) names and the second is 
the user name in whose catalog the file (or tibrary) 
resides. If only a single elements file (or tibrary) name 
is givens the file tor tibrary) is acquired from the 
current user's catalog. 


The next three parameters (combines add» and replace) specify 
modules) or modute subrange(s) to be included on the new Jibrary 
from the files specified by the file or ftibrary parameter. Noneys 
ones two or all three parameters may be specified. If none are 
specifieds allt the modules on the files specified by the fite or 
fibrary parameter is included on the new Jibrary.e. Onty the first 
occurrence of duplicate modules are inctuded in the new library. 
As explained bellows the particular parameter(s) used give you 
control over whether the given modules should exist on the base 
library(s). 


combine or co 3: 
{optional) module(s) to be included in the new Itlibrarye 
The specified moduie(s) may or may not exist on the base 
flibrary{s). If they exists they are replaced. 


add : 
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replace 


after o 


base or 


upon or 


tock or 


{optional) modute({s) to be ADDed on the new tibrary.~ If a 
specified module duplicates a module already on a fibrary 
specified by the base parameters, a fatal error is issued. 


or rep ? 

(optional) module(s) to be REPLACEd on the new tibrary. 
If a specified module does not already exist in a library 
specified by the base parameters a fatal error is issued. 


r af or before or be : 
(optional) module on a base library after or before which 
to position the new modutes. Default position is after 
the fast module on the ltast base fibrary. 


b or baselib or bf : 

{optional) list of filename-username pairs that determine a 
fist of base file(s) or library(s) to be included in the 
new object file. Al! modules from the base files {or 
libraries) become part of the new object file except 
duplicate modules (the first occurrence of the module takes 
precedence). The specified file(s) may or may not be 
fibrary(s)»s but if the baselib or bi keyword is used to 
code the parameters, they gust be tibrary(s). Each element 
in the ist of files (or tibraries) can itself be a Fist of 
two etfementss the first being the name of the file (Cor 
library)» and the second being the name of the user in 
whose catatog the file for ftibrary) resides. If onty one 
element is specifieds the file (or tibrary) is acquired 
from the current user's cataloge 


up 3 

name of file to receive the generated object Jibrarys pilus 
an (optional) user name in whose catalog the new object 
library is to be placeds if it is not in the current user's 
catalog. If you code a file name and a user names they 
must be coded as a list of two elements, the first of which 
is the file names and the second the user name, If you 
just code the fite names the upon file is placed in the 
current user's catalog. If the user name refers to another 
user's catalogs the upon file nust already exist in that 
user's catalog. 


nofock : 
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these (optional) parameters determine whether the tibrary 
update process is interlocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the intertock file. Interlocking is the default 
action when the library being updated is in another user's 
catalog. If you dontt code either of the tock or nolock 
Keays» interiocking is controlled by the ftokmode profile 
variable, Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the fock and noftock parameters. If 
you don't code a filename For the tock parameters the 
contents of profile variable intriok is used as the 
interlock filename; if there's no such oprofile variabties 
the name intriok is used as the lock filename. The 
interlock file must be in the same catalog as the tibrary 
being updated. If the interlock file cannot be founds the 
procedure aborts. 


listing or tist : 


(optional) name of tisting file on which the names of the 
modules on the new library are tisted in the order in 
which they occur as weli as the file from which they 
Came» If this parameter is not specifieds no "listing” 
output is produced. 


msg or nomsg : 


these {(optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES", 


Exampies of GOL Usage 


sesegol file=((coconutspaim)) tist=rocker upon=nentid 


* 


OBJECT LIBRARY GENERATED 


This command creates a tibrary newtib which contains ail the 


modules 


from file coconut (may be tibrary)s obtained from the 


catalog of user patm. Display information appears on File rocker. 
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sesegol tibzinptiib add=moreof repssameas bisbaselib up=nentib 
* OBJECT LIBRARY GENERATED 


This command creates a library newlib identical to tibrary 
baselib except that modufe sameas from tibrary inptib reptaces 
sameas and module moreof from inptib is added at the end. Display 
information appears on file output (default). 


sesegol basez(filelsfile2sfiite3) weon=newlib 
* OBJECT LIBRARY GENERATED 


This command creates a ltibrary newlib which is the combination of 
libraries filels file2 and file3s ait obtained from the current 
user*s catalog. OQniy the first occurrence of duplicate modules 
appears on the new tibrary. Display information appears on file 
output. 


sesegol (fileasfilteb) coz(tea.edinnersnitecan) afterziunch ee 
ee? basesbasetib up=nova 
* OBJECT LIBRARY GENERATED 


This command creates a tibrary nova using tibrary baselib as a 
base. Modules tea thru dinner inctusive and nitecap from files 
filea and fileb (may be fibraries)s both obtained from the current 
user's catalogs are added after module tunch. Display information 
appears on file output. 
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11.5 GOE_=_GENERATE_ OBJECT FILE 


GOF Generates an Qbject Eiles or updates an existing object 
file. Alsos several files can be combined into one. GOF requires 
that there be an input file specified either by the file parameter» 
or base parameter. 


The adds replaces and combine parameterss specify exactiy which 
modules from the file(s) specified by the fille parameter to include 
on the new object files while the after and before parameters 
control the position of the new modules. Parameters to GOF are 


file or f or ftibrary or fib : | 

(optional) tist of filename-username pairs describing files 

‘(or tibraries) from which object modules specified by the 
following three parameters are to be obtained for the new 
object file. The specified filets) may or may not be 
library (sts but if the keyword used is tib or tlibrarys they 
must be ftibrary(s). Each element in the fist of file (or 
jibrary) names can either be a singite file (or tibrary) 
Names or the element can itself be a list of two elementss 
the first is the file (or library) names and the second is 
the user name In whose catalog the file (or tibrary) 
resides, If onity a singte elements file for tibrary) name 
is givens the file for tftibrary) is acquired from the 
current user's catalog. 


The next three parameters (combines adds and replace) specify 
module(s) or modute subrange{s) to be included on the new object 
file from the files specified by the file or tibrary parameter. 
Nones ones two or all three parameters may be specified. If none 
are specifieds ali the modules on the files specified by the file 
or tibrary parameter is included on the new object file. Onty the 
first occurrence of duplicate modules are inciuded in the new 
object file. As explained betows the particular parameter({s) used 
give you control over whether the given modules shoutd exist on 
the base fibrary(s). 


combine or co : 
(optional) module(s) to be included in the new object 
file. The specified modulets) may or may not exist on the 
base libraryis). If they exists they are replaced. 


add : 
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replace 


after o 


base or 


upon or 


(optional) module(s) to be ADDed on the new object file, 
If a specified module duplicates a module already on a 
library specified by the base parameters a fatal error is 
issued. 


or rep 3 
foptionat) modute{s) to be REPLACEd on the new object 
file. If a specified module does not already exist in a 
library specified by the base parameters a fatal error is 
issued. 


r af or before or be : 
{optional) module on a base library after or before which 
to position the new modules. Default position is after 
the fast module on the last base ftibrary. 


b or baselib or bi : 

{optional) fist of filename-username pairs that determine a 
fist of base filets) or Jibrary{s) to be included in the 
new object file. Ali modules from the base fifes (or 
fibraries) become part of the new object file except 
duplicate modules (the first occurrence of the module takes 
precedence), The specified file(s) may or may not be 
libraryt(s), but if the baselib or bi keyword is used to 
code the parameters they must be ltibrary(s). Each element 
in the fist of files (or ftibraries) can itseif be a list of 
two elements» the first being the name of the file (or 
fibrary)s and the second being the name of the user in 
whose catalog the file (or ftibrary) resides. If onty one 
element is specifieds the file lor tibrary) is acquired 
from the current user's catalog. 


up : 

name of file to receive the generated object Files pilus an 
(optional) user name in whose catalog the new object file 
is to be ptaceds if it is not in the current user's 
catatog.e. If you code a file name and a user names they 
must be coded as a tist of two elementss the first of which 
is the file names and the second the user names If you 
just code the file names the upon file is placed in the 
current user's catalog. If the user name refers to another 
user's catatogs the upon file gust alceady exist in that 
user's catalog. 
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fock or nolock : 

these {optionat) parameters determine whether the tibrary 
update process is interlocked against simultaneous updates; 
coding a filename for the fYock parameter determines the 
name of the Interlock file. Interlocking is the default 
action when the tibrary being updated is in another user's 
catalog. If you don*t code either of the tock or notock 
keys» intertocking is controlled by the lokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tlokmode 
profile variable and the tock and notock parameters. If 
you don't code a filename for the tock parameters the 
contents of profile variable intrtok is used as the 
interlock filename; if there's no such profile variables 
the name intriok is used as the tock filename. The 
intertock file must be in the same catalog as the tibrary 
being updated.» If the interlock file cannot be founds, the 
procedure aborts. 


fisting or tist : 
(optional) name of fisting file on which the names of the 
names of the modules on the new tibrary are ftisted in the 
order in which they occur as wetl as the file from which 
they came. If this parameter is not specifieds no 
"tisting”™ output is produced. 


msg or nomsg : 
these {optional) keys control! the generation of 
informative messages by this procedure and are “fully 
described in section 1.8 -— "INFORMATIVE MESSAGES FROM SES 
PROCEDURES"™. 


Examples of GOF Usage 


sesegof fFilez((filexsusxds(fileysusy)) listztistx upznewfile 
* OBJECT FILE GENERATED 


This command creates an object Fite newfile which contains ait 
the modules from the object files filex (obtained from the catalog 
of usx) and fitey (obtained from the catatog of usy). File filex 
and filey can in fact be fibrary{s). Display information appears on 
file listx. 
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sesegof tibzinptib add=modl rep=mod2 bezbaselib up=(nfilesnusr) 
* LOCKING NEWFILE VIA INTRLOK 

* NEWFILE LOCKED 

* NEWFILE UNLOCKED ~ 

* OBJECT FILE GENERATED 


This command creates an object file nftile identicai to tibrary 
baselib except that module mod2 from tibrary inptib replaces mod2 
and modute modl from inptib is added at the end. Note that file 
nfile is specified as being in the catalog of nustr»s so the object 
library update is automatically interlocked. Display information 
appears on file output (default). 


sesegof basez(filelsfile2sfite3) uponztatest 
* OBJECT FILE GENERATED 


This command creates an object fite tftatest which is the 
combination of tibraries filels» file2 and file3. Oniy the first 
occurrence of duplicate modules appears on the new tlibrary. Display 
information appears on file output. 


sesegof (fileasfileb) coz{modaeemodbsmodc) after=modx ee 
ee? basez{((baselibsolduser)) upznewob jf 
* OBJECT FILE GENERATED 


This command creates an object file newobjf using library baselib 
(obtained from the catalog of olduser) as a base. Modules moda thru 
modb inciusives and modcs from files filea and flifeb (may be 
libraries) are added after module modx. Display information appears 
on file output. 
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12.0 SOURCE_TEXT_PREPROCES S085 


The utilities described in this section comprise a general set of 
reformatting facilities for source text. They are described briefly 
heres and more detailed descriptions follow. 


CYBFORM a source code formatter for CYBIL 
ISWLFRM a source code formatter for ISWL 


PSEUDO text preprocessor that can generate repetitive sequences of 
text. 


FSFORM formats Fortran 5 source text. 
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12.1 CYBEORM =_CYBIL SOURCE TEXT REEORMATIER 


CYBFORM is a source code reformatter for CYB8IL» such that program 
readability and consistency of presentation are enhanced. The 
operation of this procedure differs from that described in the 
CYBFORM ERS in that this procedure rewinds both the input and output 
files before and after the reformatting operation, Note that 
CYBFORM can handie multi record files. Parameters to CYBFORM are 3? 


for f 3 
name of Input File containing the CYBIL source text to be 
reformatted. 


° 
oo 


{optional) name of file to receive the Output form 
CYBFORM. If you dontt code the o parameters CYBFORM 
places the output on the file specified by the i 
parameter. 
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1202 TSadLFRM_=_TSuL_ SOURCE TEXT _REFORMATIER 


ISWLFRM reformats ISWL source codes such that program readability 
and consistency of presentation are enhanced. Parameters to ISWLFERM 
are 3 . 


i or f 3 
name of Input File containing the ISWL source text to be 
reformatted. 


0 3 
(optional) name of file to receive the Output form 
ISWLERM,. If you dontt code the o parameters ISWLFRM 
places the output on the fite specified by the i 
parameter. 
he en ee ee ee ce ee ee ae ee a ee a ae a a ee A A a SO AND HD A a ES PSD AD ID SD OD MD SD SO SE SR SE SO aS ee DD na eens ee + 
: summary of Eormatting Dicectives : 
3 a 
H Directives are given to the ISWL formatter by embedding } 
; cdbscter ek comment toggle pide in the input ISWL source code 4 : 
ee oe oe eee ee eee fp cee 00 ee ee we ee ee ee oe en ee ee ee tt me am 
H T Shee H Select cilia aehe formattinge : 
$ wee ee eee ee fn a a ee eee eee ee ee ee —---- + 
; "SP" : Turn off comment formatting. ; 
$a Sem ee + 
H "EPR" + Discard ei etths line Sumhwn ax if anys and generate i 
H $ new tine number Se : 
$ ee eee ee ee Sn me me ae ee eee + 
H "SPN" : Discard seistind line hgnberes if anys and a not 3 
; $ generate new tine numbers. ; 
$e ee ewe be ee a ee wwe: + 
H "gps" +; Preserve existing Line numbers. H 
ae ae oe ae see ee we ee a anaes cee Ap a ee SO ee A A SS A SL A SS SA ES RS SE SA RD NN a + 
H "$PB" H Preserve existing blank lines. H 
$ eee ww ew ee $n ee ee en ee ee ee eee ne = + 
H "$Pu" H Capitalize ISWt Reyeor oss H 
$e ee eee eee $e we ee ee + 
; @"¢Men>" 3 ISWL Margin chop. Formatter wraps line around at $ 
; ; N- bs oraracter positions : 
> At NS EN Ree Ee Sette in Siete cme ae etn +> SO A ERAN ANE ME A A AG ANS A ANG SARE ENS AND A EN ETS ED “EET TD AEN SEN EN TT AID OED AAAS GENS SEE AE WED ERG AES SEE SE NS EN EN EE GR A eS ee a + 


Default selections 3: "$M72" “$P5" "¢p-" 
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Note : ISWLFRM assumes a syntactically correct ISWL programe 
Syntax errors may cause undesired results on the output file. 
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12-3 PSEUDO_-_RUN_ PSEUDO _PREPROCESSOR 


PSEUDO is a text preprocessor which enables parameterized 
replication of setected portions of a text file. The parameters to 
this procedure are: 


ior f 3 
name of the Input File containing the text to be processed 
by PSEUDO. 


(optional) name of file to receive the Output from 
PSEUDO. If you don't code the oOo parameters PSEUDD 
directs the output to the file specified by the i 
parameter. 


mi: 
(optional) mame of file to receive the secondary output { 
Messages) from PSEUDG. If you don't code the m parameters 
PSEUDO piaces the Messages output if any) on a file 
called MSGS. 

op : 


(optional) name of the file to receive the statistics (and 
any error messages) from the run. If you don't code the 
op parameters PSEUDO writes this information to File 
DUTPUT. 


COMPANY PRIVATE 


12-6 
COC - SOFTWARE ENGINEERING SERVICES 


7430/8 
piiaeeioe o SES (Release 17) User's Handbook REV: AB 


12.0 SOURCE TEXT PREPROCESSORS 
1224 FSFORM - FORTRAN 5 SQURCE TEXT REFORMATTER. 


1264 ESEQRM_=_ FORTRAN 3 SOURCE _TEXT REFORMATTIER: 


FSFORM reformats FORTRAN-5 source text to reflect the nesting 
fevels of IF-THEN-ELSE biocks and DG toops. Parameters are ;3 


ior ft 3 
name of Input Eile containing the FINS source text to be 
reformatted by FOFORM, 


(optional) name of file to receive the Qutput from F5SFORM. 
If you don't code the o parameters F5SFORM places the 
resuitant formatted text on the file specified by the i 
parameter. 


Exampies of F5FORM Usage 


ses.f5form izmessys ozlovely 
* END FSOSFORM MESSY -> LOVELY 


sesef5form modern 
* END F5FORM MODERN 
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13.0 SES_COMMUNICATIONS 


User_to. User Communications 


SES provides a communication system such that users can send 
files between Sunnyvaie and Arden Hiltss and can atso MAIL messages 
to each other. To receive mails you need a MAILBOX in your 
catalog. A MAILBOX is created by using the SES NEWMAIL procedures 
When you create a PROFILE using the BuiLD PROFILE (CBLDPROF) 
procedure mentioned in the introductions a MAILBOX is also created. 


SEND send fites between Sunnyvale and Arden Hills NOS 
development machines. 


NEWMAIL creates a new mailbox. You also use NEWMAIL when you want 
to "clear out" the contents of the maitbox. 


GETMAIL displays the mail from your maitbox at your terminats or 
alternativelys the mail can be placed in a fite for 
subsequent printing or whatever. 


MAIL send mall to other users. 
SAVMAIL saves the contents of your mailbox. 
ANYMAIL telis you how many items of mail are in your maitbox. 


WHOMAIL telis you who sent the items of mail that are in your 
maitbox.e 


CHKMAIL a procedure SEGMENT that you can INCLUDE into your PROFILE, 
so that if there ts any mail in your maitbox», you get a 
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13.20 SES COMMUNICATIONS 


message every time you use SES. 
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13.0 SES COMMUNICATIONS 


The MAIL procedure puts a tine at the start of every message that 
shows you the user name (and possibly the real name) of the person 
who sent you the message. It's possible to have your name (in 
characters) included in this by defining a myname PROFILE variable 
as a strings as follows : 


\ myname = "Ethel Snerge* 


Now every time you send a mailbox message to somebody via the 
MAIL procedures the header of the message in the destination mailbox 
reads : 


FROM USER ES91 ( Ethel Snerge ») ON NOV 199 1977 AT 9333 AM 


MAIL aiso provides the facility to equate peopies! real names 
with their user names» so that you can send mail tos says freds 
instead of fjc0795 or some other cryptic nachine oriented name. You 
can do this by putting statements tike this in your profife : 


IF PROCNAM = *MAIL*® THEN 
fred = *FJjJC0795! 
bill = "wAHOOO1! 
andy = *AJL6655' 

IFEND 


Fa i ll al ol 


This series of SES directives in your profile defines the names 
givens but onty when the procedure being used is MAIL. Nows you can 
send mail like this 3: 

sesemail fetters to (freds bilts andy) 


Note that when you are using equated names of this type you must 
use the to keyword on the MAIL procedure instead of the un keyword. 
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Remote Mainframe Communications 


SES provides a set of procedures to submit jobs and manipulate 
permanent files on remote mainframes» linked via the RBF/E200UT 
network. Here is a summary of the remote access procedures 3: 


SUBMIT SUBMIIs a file to be processed as a batch job on the 
specified mainframe. 


GETPF GEIs a Permanent Eite (direct or indirect) from a remote 
mainframe to a # permanent file (direct) on the local 
mainframe. 


SENDPF SENDs a copy of a Permanent Eile (direct or indirect) to 
a direct permanent file on a remote mainframe. 


CHANGPF CHANGes parameters of a Permanent File on a remote 
mainframe. 


PURGPF PURGES {removes) a Permanent Elie from aeremote 
mainframe, 


PERMPF PERMits another user access to a Permanent Eile. 


CATPF displays CAIlist information about Permanent Eiles 
existing on the remote mainframe. 


DISPOSE PRINTs a file from the tocal mainframe on aoeprinter at 
the remote mainframe. 
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Each mainframe has been assigned a site identifier. These site 
identifiers are 3 


ARH - Arden Hillis 176 S/N 101 
SVL - Sunnyvale 176 S/N 112 
AS2 - Arden Hills 32 


Note : As additional systems are added to the networks they are 
assigned a site identifier. 


In addition to the site-ids each user must have a vatid user 
names passwords charge number and project number for the target 
machine. These may be coded {nto your PROFILE. The PROFILE 
variables are created by concatenating the site-id with 'fam' for 
family names ‘use’ for user names ‘pas! for passwords ‘fcha* for 
charges and ‘pro! for project. Users may have PROFILE variables for 
each remote mainframe they are vatidated to run jobs on. In 
interactive modes the remote tink procs requests the family names 
user names passwords charges and project variabies if they are not 
in your PROFILE. 


Note =: that in batch mode» the variable must exist in vourc PROEILE> 
or the iob aborts. 


EXAMPLE : The variabtes needed for a Sunnyvale user to run jobs 
on the Arden Hilts $2 would be 3 


PROFILE 

\ AS2USE = "your S2 user name* 

\ AS2PAS = "your S2 password? 

\ AS2CHA = "your S2 charge number? 
\ AS2PRO = "your $2 project number * 
\ AS2FAM = "your S2 family name?® 


If the value for a remote site charge parameter is set to a nu}! 
string (for example SVLCHA = '%)» the remote tink procedures omit 
the CHARGE statement in the job control statement stream that is 
sent to the remote mainframe for execution. 


If a remote site family name is set to a nulf string (for example 


ARHFAM = #4), the family parameter isn't specified on the USER 
statement. 
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13-1 SEND -_ TRANSMIT FILES BETWEEN NOS SITES 


SEND is a facitity to transmit files between NOS sites. 


When you SEND a file to a remote users a copy of the file is 
placed in the special catalog CBE at the remote site. This copy of 
the file is a DIRECT access file which is defined with a UNIQUE 
name. The receiver is given WRITE permission on the files and a 
message is mailed to the receiver to inform him of the real name of 
the file you sents and the unique name assigned to the file in the 
C8E catalog. The receiver should copy the file to his own catalogs 
and then PURGE the file from the C8E catalog. Note that if the 
receiver doesn't have a mailboxs he won't be informed that the file 
is there. Parameters to SEND are 3: 


file or f or i ?: 
name of the file to be sent to the remote user. 


un or to 3 
User Name of the user TO whom the file is to be sent. 


at or in 2 
Identifier of the site (7 characters or fess) AT or i$=IN 
which the receiver resides. 
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Example of SEND Usage 


sesesend binfile to hm00612 at svtll12 
* END SEND BINFILE -> HM00612 AT SVL 


sesesend regards to rdp at arhlol 
* END SEND REGARDS => RDP AT ARH 


The two examples show SEND used with all its parameters. One 
sender is assumed to be in Arden Hills €ARH101) sending to someone 
in Sunnyvate (SVL112)»5 and the other example shows the reverse 
situation. 


Example of MAIL messages received from SEND 


When a remote user sends you files» you receive mail messages 
something like the following : 


sesegetmai i 
* MAILBOX CONTENTS 
* 


FROM USER CBE ( CYBER 18 RECEIVER ) ON JAN 149 1980 AT 12233 PM 
FILE ASORT#=2Q06B852/UN2CBE FROM REF (RODNEY FOTHERINGAY) IS AVAILABLE 


92 8D 20 00 00 90 98 


FROM USER CBE ¢( CYBER 18 RECEIVER ) ON JAN 15s 1980 AT 12245 PM 
FILE GOF*ZQZWBXG/UN=C8E FROM ERP CEARNEST POSTLETHWAITE) IS AVAILABLE 


20 00 08 08 80 88 08 08 8 


¥ END GETMAIL 


Now you ATTACH the files from the C8E catalogs copy them to your 


own catalogs and finally purge them from the C8E catalog (and please 
remember the tast step). 
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13.2 MAIL = SEND MAIL _[O_OTHER_USERS 


MAIL is the procedure to send mail to other users! mailboxi{s). 
Parameters to MAIL are? 


ior f : 
(optional) name of Input File containing the mailto be 
transmitted to the mallboxe(s). If you don't code the i 
parameters MAIL takes the message from file INPUT» so that 
if you're at the terminals it prompts for the message. 


un or to ;3 
iist of User Names to whom the mail is to be sent TQ. 


at or in ? 
{optional) identifier of the site (machine identifier) AT 
which the addressees reside. <All addressees in the Ttist 
{if more than one) must be at the same site. If you don't 
code the at parameters, mail is sent to users on the machine 
you're running on. 


MAIL_Addressees_who. do oot havea MAILBOX 


It may happen that one or more peopie to whom you're sending mail 
don't have a MAILBOX. In this cases if the source of mail is a 
terminal file (such as INPUT)» MAIL saves the message you so 
laboriously typed in on a unique named files and issues a message to 
that effect. If the mail message was on a permanent files of course 
it is teft ftocal anyway. 
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Exampte of MAIL Usage 


sesemaii unz=j303 
Alex 3. 

I*ve made the modifications to SESPROC and 
reptaced it on SESLNAM. 


He wa we 


END MAIL INPUT -> J303 


sesemaif missifs to (shermans bobs jim) at arhlol 
* END MAIL MISSIFS <-> SHERMAN..JIM 
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1323 GETMAIL.=_DISPLAY _MAIL_EROM MAILBOX 


GETMAIL displays the contents of your mailbox on a files output 
{the terminal if you're an interactive user) by default. Parameters 
to GETMAIL are 3 


o or output : 
(optional) name of file to receive the Output from 
GETMAIL. If you dontt code the o parameters GETMAIL 
displays the mail on file QUTPUT. 


seq : 
if you code this loptional) keys GETMAIL writes the 
contents of your mailbox with each tJine SEQuenced (the 
sequence number will be on the fteft end of the tines). 
This feature is usefuls for examples for extracting 
information from your maitbox via the SELECT procedure 
(desribed in another section of this document). 


Example of GETMAIL Usage 


sesegetmail 
* MAILBOX CONTENTS 


* 
FROM USER HNO3 (Valery Vitriotix) ON NOV 45s 77 AT 4233 PM 
Sam 3 
New version of program now availabie on the 
project program fibrarye seseeeVal 
* END GETMAIL 
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13.4 NEWMAIL = _CREATE_A_NEW_ MAILBOX /4_CLEAR_EXISTING MAILBOX 


NEWMAIL creates a new mailbox if one doesn't already exist in 
your catalog. If a mailbox already exists» NEWMAIL deletes any 
items oreviousty examined via GETMAIL. There are no parameters to 
NEWMAILs you simply code : 


sesenewmail. 
Atso see the introduction to the Handbook for the description of 
the BuilD PROFifte (BLDPROF) procedures which in addition to creating 


a profile for yous creates your mailbox as part of setting up your 
initial SES environment. 
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13.5 ANYMALL.=. COUNT _NUMBER_QE_ITEMS_IN. MAILBOX 


ANYMAIL informs you of how many items there are in your mailbox. 
There are no parameters to ANYMAIL» you simply code ; 


seseanymail 


Examples of ANYMAIL Usage 


seseanymail 
& LETTER(S) IN MAILBOX 

* END ANYMAIL 
sesegetmail storage 
¥ END GETMAIL 
sesenewmail 
* END NEWMAIL 

seseanymail 

NO MAIL TODAY 
* END ANYMAIL 


The exampie shows ANYMAIL stating that there are four letters in 
your mailbox. After doing a GETMAIL to place the mailbox contents 
on file storages and a NEWMALL to clear out your mailboxs the second 
cali to ANYMAIL informs you that there is no mail in the mailbox. 
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13.6 WHOMAIL _=-_ DISPLAY LIST _OE_USERS WHO _HAVE SENT _MAIL 


WHOMAIL diselays the tist of users WHO have sent MAIL to your 
mailbox since the last time you did a NEWMAIL. The user name of 
each user is displayed along with the date and time that the message 
was sent. There are no parameters to WHOMAIL. 


Example of WHOMAIL Usage 


sesewhomail 
FROM USER AEN (Alfred E. Neumann) ON NOV 22 79 AT 5310 PM 
FROM USER FOR ON DEC lls 79 AT 4332 AM 
FROM USER JEK GN JAN 2s 80 AT 3310 PM 
FROM USER JXH (Jack Horner) ON FEB 5s 80 AT 8215 AM 
* END WHOMAIL 


This exampie shows the results when there are 4 messages in your 
maitbox at the time WHOMAIL is used. If there are no messagess the 
onty output from WHOMATL is the ending message (* END WHOMAIL). 
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1367 LAVMAIL =_SAVE_MAILBOX 


SAVMAIL saves your mailbox as a text record on a multirecords 
direct access» permanent file called GLOMAIL. If there's no file 
calted OLDMAIL in your catatogs SAVMAIL creates onew Parameters to 
SAVMATIL are: 


title or t : 
{optional) seven (7) character name of the text record on 
QOLOMAIL to contain the current contents of your mailbox. 
If you don't code the title parameters SAVMAIL creates a 
name beginning with the tetter M and followed by the 
current date in the form mmddyy. 


Examples of SAVMAIL Usage 


sesesavmail titie=psr421 
* END SAVMAIL MAILBOX => OLDMAIL 


This example shows the case where it was desired that the message 
in the mailbox be saved under an fitdentifiable name tfike a PSR 
number e 


sesesavmai | 
¥ END SAVMAIL MAILBOX => OLDMAIL 


If this example were run on April 229 1979s your mailbox would be 
saved as record M042279 on OLDMAIL. 


Note : see the Chapter on LIBRARY MANAGEMENTs especially the 
GETMEM{S) orocedures for some words on how to handte multi record 
Files. 
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13.8 CHKMAIL =. CHECK YOUR MAILBOX 


CHKMAIL is not actually an SES procedure that you can use via a 
sesechkmail statements, rather it is an INCLUDE file. The way to use 
it ts to INCLUDE it into your PROFILEs with an SES directive like 
this in your PROFILE: 


\ INCLUDE "CHKMAIL's L2UNIQUEC(NAME)s LPFN=SESLNAMs UN2SESUNAM 


This SES directive fine arranges that every time you use any SES 
procedure (with the exception of the MAIL procedures)» the CHKMAIL 
segment checks your MAILBOX for messages» and if there are any» it 
issues a message to tell you to fook at your mail. 
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13-9 SUBMIT =_SUBMIT_A_JOB_TQ_BE_ PROCESSED_AT_A_ REMOTE SITE 


SUBMIT provides a method for running a job on aeremote 
mainframe. A user provided job file is processed as a batch job on 
the specified mainframe. A user job for 170 mode execution is 
responsibte for getting its output sent to any site other than the 
one the job runs one This can be done by coding an SES~DISPOSE or 
an SES.SENDPF as part of the job. If neither of these are codeds 
the output is printed at the remote site where the job is run. 


A user job for 180 mode execution {applicabfte to the $2 site 
oniy) automatically has its output returned and printed at the focal 
site where the user originated the job. 


f or fn : 
name of file containing the job to be processed. 


at or on 3 
site-id of the mainframe that the job is to run one 


mode 3 
(optional) vaiue (170 or 180) to indicate execution mode for 
the job at the remote site; default is mode=1703; the mode 
paraneter is applicable only to jobs to be run on the $2 
remote site. 


You can set a defauit for the mode parameter by defining the 
submode variable in your profile. For instances \SUBMODE=180 in the 
PROFILE submits al! jobs in 180 mode unfess mode=170 is coded when 
the SUBMIT proc is run. 
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13.10 GETPE_=_GET_A_ PERMANENT FILE _EROM A REMOTE SITE 


GETPF ACQUIRE's a file from a remote mainframe and makes a copy 
of it in your catalog on the focal mainframe. The copy created on 
the local mainframe is a direct access file. If the file is not 
under your user number on the remote mainframes you must have 
permission to access the File. Parameters to GETPF are : 


ofn 3: 
name of file to be acquired on the remote mainframe, 


at or on : 
site-id of the mainframe from which the file is to be 
acquired. 


un 3 
(optional) user number of the catalog the fiie is under on the 
remote mainframe. If this parameter is not codeds GETPF uses 
the user number value for this site from your PROFILE. 


nfn 3: 
{optional) name to be used for the copy of the file created in 
your cataleg on the local mainframe. If this parameter is not 
coded» GETPF uses the vatue for ofn. If nfn atready exists in 
your catalogs GETPF terminates with an error statuses GETPF 
creates nffn as a direct access file. 


status or nostat ;: 
coding the (optional) status key causes a message to be placed 
in your mailbox when GETPF completes. When the nostat key is 
coded» you aren't notified of GETPF*s completions or whether 
it was sucessful. The default is no message upon completion. 
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13.11 SENDPE.=_SEND_A_ PERMANENT _EILE_TO_A_BEMOTE_SITE 


SENDPF copies a fite from a tocai mainframe to aeremote 
mainframe. If the fite already exists,» it is rewritten. Parameters 
for SENDPF are 3 


ofn 3: 
name of file on the tocal mainframe that is to be copied to 
the remote mainframe. 


at or on 3 
Ssite-id of the remote mainframe. 


un : 
(optional) user name that the local file is cataloged under. 
If this parameter is not codeds your user name is used. 


nfn : 
(optional) name of file to be created on the remote 
mainframe. If this parameter is not codeds SENDPF uses’ the 
value of ofn. If file nfn already exists on the remote 
mainframes SENDPF writes the new file over it. SENDPF creates 
nfn as a direct access file. 


status or nostat : 
coding the (optional) status key causes a message to be placed 
in your maiitbox when SENDPF completes. When the nostat key is 
coded»s you aren't notified when SENDPF completes. The default 
is no message upon completion. 
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13.12 CHANGPE_-_ CHANGE. PARAMETERS _GE_A_PERMANENT_EILE 


CHANGPF modifies parameters of a permanent file on a remote 
mainframe without re-defining it. Parameters for CHANGPF are : 


ofn : 
name of the file on the remote mainframe to be changed. 


at or on : 
site-id of the remote mainframe. 


nfn 3 
(optional) new name of the file on the remote mainframe. 


et : 
(optional) new file category. Must be P (private)s S 
(semiprivate) or PU (public). If the parameter is not codeds 
the file category is not changed. 


m3: 
(optional) new access mode for the file. Must be Wlwrite)ds 
M(modify)>s Alappend)>» R(read)>» RM{readmd)>» RAlreadap)»s 
ECexecute)s or N(nult—removes permission granted by permission 
commands ). If the parameter is not codeds the access mode 
isn't changed. 


pw : 
(optional) new password (1 to 7 characters) for the file. If 
this parameter is not coded» the password isntt changed. 


status or nostat : 
coding the (optional) status key causes a message to be placed 
in your mailbox when CHANGPF completes. When the nostat key 
is codeds you aren't notified when CHANGPF compfetes. The 
default is no message upon completion. 
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13.13 PURGPE_=_REMOVE (PURGE) A_ PERMANENT _EILE 


PURGPF removes a permanent file from a remote mainframe, If the 
file is not in your own cataiogs you must have write permission iin 
order to purge it. Parameters for PURGPF are : 


ofn 3? 
name of file to be purged. 


at or on: 
the site-id of the remote mainframe. 


un ?: 
(optional) user name on the remote mainframe that ofn is 
cataloged under. 


status or nostat : 
coding the Coptional) status key causes a message to be placed 
in your mailbox when PURGPF completes. When the nostat key is 
coded you aren't notified when PURGPF completes. The default 
is no message upon completion, 
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13.14 PERMPE =_PERMIT_ACCESS_TO_A_PERMANENT_EILE 


PERMPF explicitiy oermits another user to access a file in your 
catalog on a remote nainframe. Parameters to PERMPF are 3 


ofn 3 
name of file for which access is being permitted. 


at or on : 
site-id of the mainframe the file is on. 


un 3 
user name to be permitted access to the file. 


(optional) permitted mode of access. If this parameter is 
not codeds R (read) permission is used. 


status or nostat : 
coding the (optional) status key causes a message to be 
placed in your maitbox when PERMPF completes. When the 
nostat key is codeds you aren't notified of PERMPFfs 
completion. the default is no message upon completion. 
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13.15 CAIPE.=_DISPLAYS INEQRMATION_ ABOQUI_A_EILE 


CATPF displays CATtHist information about Permanent Files on a 
remote mainframe. Parameters to CATPF are 3 


ofn : 
{optionai) File name that catalog information is desired for. 


at or on: 
(required) site-id of remote mainframe to get catlist 
information from. 


un ? 
(optional) user number of an alternative catatog on the remote 
mainframe. 


lo : 
foptional) tist options for NOS CATLIST command. Default is 
full information (F). 


fisting or 1! :; 
(optional) name of file on the tocat mainframe to receive 
fisting. If this parameter is not codeds the Jlisting is 
printed at the ltocal mainframe central site. 


status or nostat ;: 
coding the (optional) status key causes a message to be placed 
in your mailbox when CATPF compietes. When the nostat key is 
coded» you aren't notified of CATPF's completion. Defauit is 
no message upon completion. 
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13.16 DISPOSE_=_PRINT_A_EILE_AT_A_REMOTE_SITE 


DISPOSE prints a file from the local mainframe on a printer at 
the remote mainframe. Parameters to DISPOSE are 3: 


file or f 3 
name of file to be printed. 


at or on : 
site-id of remote mainframe where file is printed. 


print or p ? 

(optional) string containing parameters to control the action 
of the SES PRINT procedure which is used to print the file at 
the remote site. If you don't code the print parameters 
DISPOSE prints one copy of the file at the remote site. For 
a complete description of the vatues that may be coded (For 
the print parameters, see the description of the procedure 
PRINT in the SES USERS HANDBOOK. 
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Alphabetical _Summary.of Remote Link Procedures 


Non-bracketed parameters are required. 


CATPF Cofnis ats CLunls [lol>s Clistingls Ustatus] 
CHANGPF ofns at» [nfn]}>, Ccetl> Cm]» Cpwl>» Cstatus] 


DISPOSE files ats Cprinti 


GETPF ofns ats Cunls {nfnl> Cstatus] 
PERMPF ofns ats uns Cmis Cstatus] 
PURGPF ofns ats CTunl>s Cstatus] 


SENDPF ofns ats Cunls CfnfI>» Cstatus] 


SUBMIT f> at» (model 
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14.0 TEXT MANIPULATION _AND_ CONVERSION UTILITIES 


This section describes a list of facilities to perform general 
massaging of text files, character set conversion and so one “The 
facilities to be described are : 


EDT run the EDT text editor on a file 

LOWTOUP convert fower case letters to upper case 

UPTOLOW convert upper case fetters to lower case 

COPYACR copy ASCII coded record 

ASORT sort ASCII files 

UNIQUE removes adjacent duplicate lines from a text file 

MERGE merge up to five files on a columnar basis 

DEMERGE sptit a file into one to five files on a columnar basis 


COMPARE compare two text files and produce a fisting of the 
differences between them. 


COUNT counts characterss wordss or tines in a text file 


SELECT extracts (displays) selected lines and/or ranges of tines 
from a text file 


MULTED MULTI record file EDIT facility. 
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14.9 TEXT 


MANIPULATION AND CONVERSION UTILITIES 


PACK 


UNPACK 


CONV 


JABFORM 


SNOBOL 


FIND 


CHANGE 


XLIT 


"Packs" a multi record or multi file file into ae singte 
text records with control characters such that it can be 
*unpacked™ again. 


"npacks™s that is» reverses the action of PACK. 


CONVert the character set of a text file 


convert source for the TEXTJAB document formatter to source 
for the TXTFORM document formatter 


8=-bit SNOBOL interpreter. 


search a file for specified text patterns. 


change matched text lines in a file. 


transiiterate characters in a file 
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14.1 EQT_=_RUN_THE EDIT_TEXT_EOITOR 


EDT runs the EDT text editor for youe EDT is an enhanced version 
of the standard NOS text editor. <A description of EDT can be found 
in an appendix to this document. This EDT procedure is mainty 
intended to work in conjunction with procedures such as GETMOD(S)» 
GETMEM(S)» PACKs UNPACK and so ons so that you cans for instances 
string a bunch of procedures togethers like 3: 


sesegetmod mzenurdie; edt; repmod 


to get a module off a bases edit it and sreptace it att in one 
procedure line. Parameters to EDT are 3; 


ior f 3 
(optional) name of Input File containing text to be 
EDiTed. If you don*t code the i parameters EDT uses the 
value of profite variable group as the name of the input 
files and if there's no such variable defineds EDT uses a 
default file name of group. 


ec or input : 
{optional) name of file containing Edit Commands to EDT. 
If you don't code the ec parameters EDT uses file input. 


eo or output ;: 
(optional) name of file to receive Edit Output. If you 
don't code the eo parameters EDT uses file output. 


t or tabs : 
(optional) TABS parameter for EDT. If you don't code the 
t parameters there are no tabs set. You may set up a 
default tabs name in your profite by defining the tabs 
variable. 


save or rep : . 
if you code this foptional) key» EDT REPltaces the file 
specified by the #§ parameter in your catalog when youve 
finished editing. If you don?t code the rep keys the file 
is left local. 
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14.2 LOWITOUR_-_CONVERT LOWER _CASE_TO_UPPER_CASE 


LOWTOUP converts all LOWer case letters in a text file to UPper 
case letters. Parameters for LOWTOUP are ; 


ior f : 


name of Inout File containing text to be processed by 
LOWTOUP. 


© 
“ 


{optionat) name of file to receive the Output from 
LOWTOUP. <If you don*tt code the o parameters, the output 
appears on the file specified by the i parameter. 


Exampte of LOWTOUP Usage 
seselonvtoup i=lowcases ozupcase 
* END LOWTOUP CLOWCASE => UPCASE 
This exampte shows LOWTQUP converting all tower case fetters ina 


file catied towcase into upper case ietterss and produce the output 
on a file caited upcecase,. 
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14.23 UPTOLOW =_CONVERT UPPER CASE _TO_ LOWER CASE 


UPTOLOW converts all UPper case tetters in a text file to LOWer 
cas@~. Parameters for UPTOLOW are 3: 


ior f 3 
name of Input File containing text to be processed oby 
UPTOLOW. 


(optional) name of file to receive the Output from 
UPTOLOW. If you don't code the o parameters the output 
appears on the file specified by the i parameter, 


Exampite of UPTOLOW Usage 


seseuptotow izuppers oxzlower 
* END UPTOLOW UPPER => LOWER 


This example shows UPTOLGW converting aft upper case tetters in a 


file called upper to tower case fetterss and producing the output on 
a file called tower. 
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1464 COPYACR_=_COPY_ ASCII CODED RECORD(S) 


COPYACR stands for COPY ASCII Coded Record(s)» and as its name 
impliess it is the ASCII equivalent to the standard NOQS COPYCR 
utility. This COPYACR procedure does a bit more than the standard 
NOS COPYCR : it acquires the input file for yous and rewrites the 
output file back over the input file if you specify it that way. 
COPYACR can also perform some character set conversions for you (see 
below). Parameters to COPYACR are 3. 


jor f 3 
name of Input File containing text to be processed by 
COPYACR. 


i] 
os 


(optional) name of file to receive the OQutput from 
COPYACR. If you don't code the o parameters the output 
appears on the file specified by the § parameter. 


cols or c 3 

{optional) specification of the COLumnS between which the 
file is to be copied. The c parameter must be coded as a 
ranges or in the form toweehighs» where fow is the teft 
column at which to start copyings and high is the right 
column beyond which the file is not to be copied. If you 
don't code the c¢ parameters COPYACR uses the range 1-280 
for the copy. 


incset or ic : 
(optional) designator for the INput filets Character SET. 
The table below describes the allowed designators. 


outcset or oc 3 
(optional) designator for the OUTput file's Character 
SET.» The tabte betow describes the allowed designators. 


Both the incset and outcset parameters default to ¢s612 (see 
below) but this can be over-ridden by defining in your profile 
defaults via variables with names the same as the parameters. The 
following table defines the allowed designators for the ineset and 
outcset parameters : 
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fe ee ee ee Se an ne ce ee + 
H | H ; 
: Desianatoc ‘ Meaning ‘ 
r ; a g 
pe ee et oe ee ee ee ae ee ae an ee ee a re ce a ee A SS SS HS I Sn + 
; ; ; 
H es612 ; NOS 6/12 ASCII character set H 
 ] $ 2 
a a 4 
+ ee ee ee ee’ +> ee ee eee + 
H H : 
H cs64@ ' 64 character ASCII subset (disptay code) §$ 
H ; character set 3 
H H ; H 
+> A DN ee AID A A A ED ND ee Se <a -— = SR 0008 NN EN NAD,“ NED TIRES ann “enllin SAAD CentER NN ND AN AND AID EE SE Sel RED SR SA TE ES ED EN OD EE Se DO ee ne ee  -e e + 
H ; ; 
; cs812 ; "8 out of 12" ASCII character set ; 
: a a 
b a a 
+ + + 


Example of COPYACR Usage 


sesecopyacr grab hold 11..17 
* END COPYACR GRAB => HOLD 


This example shows COPYACR copying file grab between columns 11 
thru 17 $inctusives and ptacing the resuit of the copy on file hold. 
You might wonder what's the use of doing that? Well the NOS CATALOG 
utility outputs the record names starting in column 11s so you could 
use this exampfe of COPYACR to isolate ail the record names. 
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1465 ASORI_=_308T_ASCII_EILES 


ASORT is a utility to sort ASCII files according to sets of sort 
directives. Parameters to ASORT are 3 


ior f 3 
name of Input File to be processed by ASORT. 


Coptional) name of file to receive the Output from ASORT. 
If you don't code the o parameters ASORT places the output 
file on the file specified by the {i parameter. 


keys : 
fist of sort KEYS to direct the sort process. Each 
element in the list of keys consists of three items. The 
first item is the start column of the fieids the second 
item is the lCloptionalt) length of the field (defauitt 1 
character)» and the third item is the (optionat) sort 
orders A for Ascendings and OD for Descending. The default 
is Ascending order. There is an exampie of ASGORT at the 
end of this description. 


retain : . 
this foptional) key is the SORT/MERGE RETAIN option. If 
you dontt code the retain keys SORT/MERGE outputs 
identically keyed records in arbitrary order. If you do 
code the retain keys such records are output in their 
original order. 


Note : the coltating sequence for ASORT is the ASCII coltating 
sequence. Upper and lower case ftetters are considered identical for 
the sort processs so that alphabetic items aren't separated by an 
entire case of the alphabet. 
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Exampie of ASORT Usage 


seseasort izshufflds ozorderiys keys=((197)s(10979d)0(2194)). 
* END ASORT SHUFFLD -> ORDERLY 


This example shows ASORT sorting the file shuffild onto the file 
orderly. The keys used are column 1 for aée=tength of seven 
characterss in ascending order (since that's the defautt)s»s column 10 
for alength of seven characters in descending orders and column 21 
for a tength of four characters» in ascending order {again 
defaulted). 


seseasort izhiggidys ozlinedups keys={((14s 3s d)) 

* END ASORT HIGGLDY -> LINEDUP 
This exampte of ASORT highlights one of the minor inconveniences of 
parameters that are tists of tists» namelys that even when you've 
onty got one key to sort ons you stil! need double parentheses. The 
following discussion explains the keys parameter. 

The keys parameter is a list of sort keys3 each element of that 
fist is itself a list of up to three elements. So at the top level 
you get this situation : 

keys=(key_l» key_2s key _3xece0 key in) 
each key_i is itseif a list of one to three elements : 
(start columns key_lengths sort direction) 


start_column is the cofumn position of the start of the sort key. 


key_ltength is the number of characters in the keys inclusive of 
start _column - the default key _length is 1. 


sort direction is a single tetter indicator : A for Ascending order 
{the default)»s D for Descending order. 


So fet's took at some real tive examples of sort keys 3: 
keys=((49 29 d)s (lls 7s d)) 
is a list for two sort keys» the first starts in column 4s is 2 
characters tongs and is sorting in descending order; the second 
starts In column lls is 7 characters longs and is also sorting in 
descending orders Here's the same tists but this time the sort 
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order is ascendings so you can feave out the direction indicators : 
keys=((45 2)5 (ils 7)) 


Now fet's look at some more default cases; suppose the column 4 key 
is onty one character long - now you can write the keys tike this 3: 


keys2((4s L)s lls 7)) 
but the key_length of one is the defaults so it can be written : 
keys#((4)5 (Lis 7)) 
harking way back to chapter 1 and the section calied “lists of 
walues for voarameters"s recail that a singte element tist doesnt 
need the parentheses 3 


keys(4s (lls 73) 


Now ‘fetts shorten it stiii further by reducing the seven character 
field to one :? 


keys2(4,» 11) 


Getting down to the ninimum case of a single key of tength one in 
ascending orders you get : 


keys24> keys=((4, 13) and keys=((4s 1s a))? are ail identical» 
whereas 3 


keys*(7» 12) means keys2#((7s 1). (125 1)) 
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1466 UNIQUE =-_REMOVE ADJACENT DUPLICATE LINES FROM A_EFILE 


UNIQUE removes adjacent duplicate lines From a text file. Such a 
situation usualty arises when a file has been sorteds {as for 
exampfie with the ASORT procedure previousty described) and dupficate 
fines in the file are ali together. UNIQUE provides the capability 
of reducing the file to one instance of each unique fine. For 
examples UNIQUE acts as follows : 


Input File Output File 
Just the piace for a Snark Just the place for a Snark 
the Bellman Cried the Beltiman cried 
the Bellman cried as he landed his crew with care 
as he landed his crew with care supoorting each one 
supporting each one on the top of the tide 
on the top of the tide with a finger entwined in his hair. 


on the top of the tide 
on the top of the tide 
with a finger entwined in his hair 


With that example to show how it workss the parameters to UNIQUE 
are 3 


ior f : 
name of the Input Eile containing the text which Is to have. 
the adjacent duplicate tines removed. 


is the (optional) name of the Qutput file from the UNIQUE 
processes If you don*t code the o parameters the resutts 
appear on the file specified by the i parameter. 
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Exampties of UNIQUE Usage. 


seseunique izsorteds o=removed 
* END UNIQUE SORTED -> REMOVED 


seseunique duplics 
a END UNIQUE DUPLICS 
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14-7 MERGE = MERGE _UP_TO_ELVE_EILES_INTO_QNE_EFILE 


MERGE combines up to five files on a columnar basis. Parameters 
to MERGE are 32. 


name of file to receive the Output of MERGE. 


m or merge : 
a list of up to five column widths specifying how the 
input files are to be MERGEd into the output file (see the 
exampie below). 


ior f : 
(optional) list of up to five Input Files to be MERGEd 
onto the File specified by the o parameter. If you donitt 
code vatues for the i parameters, MERGE uses filenames 
tapel thru tapeS for its input files. 


Exampite of MERGE Usage 


sesemerge ozdiagrams m=(21ls21921)5 i=({columnls column2s cotumn3) 
* END MERGE COLUMN1sCOLUMN2sCOLUMN3 -> DIAGRAM 


In this examptes MERGE is constructing a file called diagrams by 
merging together the three files columnls column2s and column3. The 
contents of file columnl occupy the first 21 columns in the diagram 
Files the contents of file cotumn2 occupy columns 22 thru 42 In the 
diagram files and the contents of file coftumn3 occupy coltumns 43 
thru 63 in the diagram file. 
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14.8 DEMERGE =_SPLIT_EILE_APART_BY_COLUUNS 


DEMERGE splits a file into one to five files on a columnar 
basis. Parameters to DEMERGE are : 


ior f 3 
name of Input Fite which is to be DEMERGEd. 


dor demerge : 
a list of up to five cotumn widths specifying how the 
input file is to be DEMERGEd into the output files (see 
the example below). 


(optional) tist of up to Five files to receive the Qutput 
of DEMERGE. If you don't code vaiues for the o parameters 
DEMERGE uses tapel thru tape5. 


Exampie of DEMERGE Usage 


sesedemerge izcompilfes d=(81s23)5 ozfsources numbers) 
* END DEMERGE COMPILE => SGURCEs NUMBERS 


This exampte shows DEMERGE spiitting up a File catted compite 
into two components. In this example (taken from real fife), the 
first 81 columns of compile are the source statements from a master 
audit of a deck in an UPDATE PL» and the Yast 23 columns are the 
statement numbers. The two separate sets of data appear in the 
exampte on files source and numbers. 
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14.9 COMPARE =_COMPARE_IEXT_EILES 


The COMPARE procedure compares two text files and produces a 
"fisting" of the differences between them in terms of inserteds 
deleteds and replaced tines. Parameters to COMPARE are 3 


new 3 
this (optional) parameter specifies the name of the file 
containing the “new” version of the text. If you dontt 
code this parameters, COMPARE uses a file cailted new. 
old : 
this {optional) parameter specifies the name of the file 
containing the "old" version of the text, If you donitt 
code this parameter, COMPARE uses a File catied otd. 
Oo 3 
this (optional) parameter specifies the name of the file to 
receive the output from COMPARE.» If you don't code this 
parameters COMPARE writes the results of the comparison to 
file output. Note that if the two files are equivalents 
COMPARE doesn't write anything to the o file. 
neweset : 
(optionat) designator for the NEW file's Character SET. 
The table below describes the allowed designators. 
oldcset ; 
{optional) designator for the OLD file's Character SET. 
The tabte betow describes the allowed designators. 
outcset ;3 


(optional) designator for the OUTput file's Character 
SET. The table below describes the allowed designators. 


is or ignorts ?: 
these (optional) keys specify whether or not to J[GNOQRe 
Leading Spaces on tines being compared. The default action 
is to recognise teading spaces (the is option). If you 
code the ignorts keys COMPARE ignores leading spaces on 
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text lines. 


The default character set designator for all three cset 
parameters is e¢s612- The following tabie defines the allowed 
designators for the cset parameters 3: 
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3 a 
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3 ; 

cs612 § NOS 6712 ASCII character set H 

3 a 

3 2 

a OL Ny SA A AN kD te va Fe ee ee ee ee oe 
: 

cs64 +; 64 character ASCII subset (display code) 

} character set ‘ 

; ; 

ee ES A Le SN SH Sh OS AO ce aN me pe ce re ee ew ee co ee ee ee ee ee a ee ae ee ee a ae ee en ee ae ae ae ae ae ee 
; : 

cs812 ? "8 out of 12" ASCII character set H 

4 s 

+ + 
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14.10 COUNT _-_COUNT_THINGS_IN_A_EILE 


COUNT counts one of the following three things in a file 3: 
characters number of ASCII characters in a file. 
fines. number of lines» 


words number of words in a Files where a "word" is defined as a 
contiguous set of characters delimited by space(s)» 
tab{s) or newline(s). 


Parameters to the COUNT procedure are 3 


c or chars or #4 or tines or wor words = 
these keys define which thing ts to be counted (Characterss 
Lines or Words). 


ior f or in :} 
name of Input Eile IN which the things are to be counted. 


o or to : 
is the foptional) name of the Qutput file [Q which the 
results of the counting process are to gow If you don't 
code the to parameters the results go to file output. 


Examptes of COUNT Usage 


sesecount lines in source 
7396 
* END COUNT SOURCE 


sesecount words in guide to resuits 
* END COUNT GUIDE =-> RESULTS 


The first exampte shows COUNT counting the number of tines in a 
file called sources with the result going to file output by 
default. The second exampie counts the number of words in a file 
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14210 COUNT - COUNT THINGS IN A FILE. 


called guides with the answer written to ae fite catied resuits. 
Note that the choice of parameter keywords means we can specify the 
COUNT process in a more "English" form. 
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1411 SELECT =_COPY_ SELECTED LINE _RANGES FROM A_EILE 


SELECT copies selected tines or ranges of lines from one fite to 
another. The default output file used by SELECT ts in fact file 
outputs so that the utility provides an easy way to look at selected 
parts of a file without needing to edit the file. Parameters to the 
SELECT procedure are 3 


tine or tines 3 
is a fist of tine numbers or line number ranges to be 
selected from the input file. 


io or f or of ? 
is the name of the Input Eile from which the tines or 
ranges of tines are to selected. 


o or to 3 
is the tootional!) name of the Qutput File IQ which the 
selected tines are to be copied. If you don't code the to 
parameters the selected tines go to file output by 
default. You can code the output file name to be the same 
as the input file name in which case the input file gets 
overwritten by the selected tines. 


Examptes of SELECT Usage 


sesesetect tine 50 of somfile 
Beware the frumious Bandersnatch my sone 
* END SELECT SOMFILE 


sesesetect lines 10..19 of nurdie to twisted 
* END SELECT NURDLE =-> TWISTED 


sesesetect tines (55979922179199232247) of primes to sifted 
* END SELECT PRIMES => SIFTED 


The three examples shown above should give a good idea of the way 
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that SELECT is useds showing a single lines a range of tiness and 
finatty a Jist of tines and line rangese Invatid tine numbers and 
ranges are diagnosed. Line ranges in which the high end of the 
range is larger than the number of fines in the input file cause the 
seiction to go to the end of the input file. 
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14.12 MULIED_-_EDIZ_MULIL_RECORD_EILE 


MULTED provides the ability (not provided by the NOS text editor) 
to edit a multi record “file. This is especially useful for 
instances where major and global changes must be made to many decks 
of a source text program library. It is easy to generate a SQURCE 
Files MULTED that files then reptace the decks on the PL. MULTED 
uses the PACK and UNPACK procedures to change the multi record file 
to a singte record file ready for editings and to reverse the 
process when editing Is complete. MULTED invokes the EDT text 
editors an enhanced version of the standard NOS text editor. A 
description of EDT can be found in an appendix to this document. 
Parameters to MULTED are: 


ior f : 
name of File containing MULTED input. 


°o 
o 


{optional) name of file to receive the OGQutput from 
MULTED. If you don't code the oo parameters the output 
appears on the File specified by the i parameter. 


ec or input 3: 
(optional) name of file containing Edit Commands to be 
used by EDT.» If you don't code the ec parameters MULTED 
assumes that the edit commands are coming from file 
INPUT. 


eo or output : 
(optional) name of file to receive Edit OQutput. If you 
don't code the eo parameters MULTED assumes that the 
output is going to file OUTPUT. 


t or tabs : 
(optional) TABS parameter for EDT.~ If you don't code the 
t oarameters MULTED doesn?t set any tabs. You may set up 
a default tabs name in your profile by defining the tabs 
variable. 


Coptional) Control Character to be used for the 
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PACK-UNPACK processe If you don't code the ce parameters 
MULTED uses a control character of stash (/). 


save or rep : 
if you code this (optional) keys MULTED REPlaces the file 
when editing ts complete. If you don't code either of 
these keyss MULTED leaves the file local. 


Exampte of using MULTED. 


sesemulted rigors mortices cc=*?? 


This example PACKs file rigors invokes EDT to edit the PACKed 
files and finally UNPACKs the file onto file mortice. The PACK 
process turns all physicatt EQR*'s and EGF's into the character 
strings ?7E0R and 7EOF respectivelys and the UNPACK process reverses 
the operation. 
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14.13 PACK =_PACK MULTI_RECORD_EILE 


PACK packs a multi record file into a single record in such a way 
that the record structure is maintaineds and may be reconstituted by 
a subsequent UNPACK. It is a useful facility when you want to edit 
a multi record text file for instance. Parameters to PACK are: 


ior f 3% 
foptional) name of Input File to be PACKed. If you don'tt 
code the i parameters PACK uses the name associated with 
profile variable group. If there isn't such ao profile 
variable defineds PACK uses a filename of group. 


o 3: 
{optional) name of file to receive the Gutput from PACK. 
If you omit this parameters the output appears on the file 
specified by the i parameter. 

cc : 


(ootional) Control Character to be used for the PACK 
process. If you dontt code the ce parameters PACK uses a 
control character of stash (/). 


Example of PACK Usage 


sesepack izmuitrecs o=packeds ccz*?! 
* END PACK MULTREC =-> PACKED 


This example shows PACK being used to "pack" a multi record file 
called muitrec and produce the output of the process on a file 
called packed. The contro! character 3 is useds so that every 
physical EDR in the file is reptaced by the character string !EOR in 
the output. 


COMPANY PRIVATE 


14-24 
CDC - SOFTWARE ENGINEERING SERVICES 
7/30/8 
14.0 TEXT MANIPULATION AND CONVERSION UTILITIES 
14.14 UNPACK - UNPACK TEXT FILE TO MULTI RECORD FILE 


14.14 UNPACK =_UNPACK TEXT _FILE_TO_ MULTI RECORD FILE 


UNP ACK provides the converse operation to that provided by PACK» 
or it unpacks a singte record text file into a multti record file. 
Parameters to UNPACK are: 


ior f 3. 
(optional) name of Input File containing data to be 
processed by UNPACK. If you don't code the & parameters 
UNPACK uses the name associated with profile variable 
group. If there isn't such a profile variable defined» 
UNPACK uses a file name of group. 


0 2 
(optional) name of file to receive the Qutput from 
UNPACKe If you don't code the o parameters the output 
appears on the file specified by the i parameter. 

ce : 


(optional) Control Character to be used for the UNPACK 
process. If you don't code the ce parameters UNPACK uses 
a control] character of siash (7). 


Exampie of UNPACK Usage 


seseunpack i=packeds ozunpackds cc=!* ? 
* END UNPACK PACKED =-> UNPACKD 


This exampie shows UNPACK being used to reverse the “pack” 
process described In the previous section. The file packed is 
tunpacked’ onto the file unpackd. The contro! character of ! is 
used so that every tine that has a SE€0R starting in column one is 
replaced with a physical end of record in the output file. 
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14.15 CONY_=_ CONVERT CHARACTER SET 


CONV converts text files from one character set to another. NOTE 
~ Due to its Flexibilitys the conversion process is fairty time 
consuming. Parameters to CONV are ? 


ior f 3: 
name of the Input File containg text to be converted. 


Coptionalt) name of the file to receive the Gutput from 
CONV. If you don't code the oo parameters» the output 
appears on the file specified by the i parameter. 


incset or fc : 
designator for the INput file's Character SET. See the 
tabte betow for a description of the allowed designators. 


outcset or oc 3 
designator for the ODUTput filets Character SET. See the 
table below for a description of the allowed designators. 


The following table defines the designators allowed for the 
inceset and outcset parameters: 


Designatoc Meaning 

N63 NOS 63 6-bit codes 

N64 NOS 64 6-bit codes 

N612 NOS 6/12 ASCII 6-bit and 12-bit codes 

N612U same as N612 except that ali tetters are upper 
case 

N612L same as N612 except that atl tetters are lower 
case 

NBE63 NOS/BE 63 6—bit codes 
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NBE64 NOS/BE 64 6-bit codes 

NBE63A NOS/BE ASCII 63 character subset 77-bit codes (5 
per word) 

NBEGGA NOS/BE ASCII 64 character subset 77-bit codes (5 
per word) 

ASCII4 full ASCII YV-bit codes (4 per word) 

ASCII5 full ASCII 7V-bit codes (5 per word) 


A table of these characters sets can be found in an appendix to 
this document. 
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14.16 JABEGRM_=_ CONVERT _TEXTJAB SOURCE TO_TXTEQRM SOURCE 


JABFORM converts source for the TEXTJAB document formatter to 
source for the TXTFORM document formatter. JABFORM only works on 
TEXTJAB source format directives that are delimited. Parameters to 
JABFORM are 3 


ior f 3 
name of the Input File containing the TEXTJAB document 
source. 


name of the file on which the TXTFORM source is written 
Dute Note that unlike many other SES procedures JABFORM 
doesn't overwrite the Input File with the Gutput file. 


{optional) name of the file to receive error messages from 
JABFORM. If you don't code the e parameter, JABFORM uses 
file ERRLIST. 


A complete description of the conversions performed by JABFORM 
can be found in an appendix to this document. 
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14.17 SNOBOL_=_8-BIT_SNOBOL_ INTERPRETER 


SNOBOL ts an 8=bit version of the SNOBOL4 interpreter. SNOBOL 
afficionados will realise that SNGBOL requires both program and data 
on the same input file; using the SES SNOBOL procedure you can (if 
you want) have the program and data on separate filess in which case 
SES gathers them onto the same file before running SNOBOL. The 
SNOBOL interpreter requires its input in 8-12 ASCII and produces its 
output in the same character set. Parameters are 3: 


Lor ft: | 
name of Input Eile containing the SNOBOL source programs 
ands if you wishs data for the program. You. can aiso 
specify a data file with the d parameter. 


gd or data : 
is the (optional) name of a Pata file for the SNOBOL 
program. If you do code this parameters the data file is 
appended to the input file specified by the i parameter. 


{optional) name of file to receive the Qutput of the SNOBOL 
run. If you don't code the o parameters the output appears 
on the file specified by the i parameter. 
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14.18 EIND.-=_EIND_PATIERNS_IN_A_EILE 


FIND searches a file fine by tines ftooking for specific text 
patterns or cegular expressions. There is a discussion on regular 
expressions tater. The pattern to be focated in the file may be 
specified on the SES control statements ors if there are flower case 
characters which can't be representeds an argument file (default 
input) may be supplied. Parameters to FIND are 2? 


p or pattern or with or using : 

(optional) pattern specification. If you don't code this 
parameter at alls» FIND takes its argument pattern from file 
inputs and prompts you accordingly. The p or pattern 
keywords or no keyword indicate that the pattern is right 
there on the SES control statement. The with or using 
keywords indicate that the pattern is In an argument file 
which is specified as the value of the parameter. 


i or in or f 3 
is the name of the Input Ette JN which the regular 
expressions are to be located, 


o or onto 3 
{optional) name of the file QNIQ which the Qutput of FIND 
is to appear. If you dontt code the o parameters the 
output appears on the file specified by the { parameter. 
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Examples of FIND Usage 


sesefind *£0-93$" in myfite onto output 
* END FIND MYFILE -> OUTPUT 


sesefind using patfile in oldfite onto foundit 
* END FIND OGLDFILE =-> FOUNDIT 


sesefind *#.*#" in compite 
* END FIND COMPILE 


The first exampie shows FIND tocating all tines in myfile that 
have a digit at the end of the line. The resuit appears on file 
output. The second exampie shows FIND used with a pattern File 
patfile. The third example is tocating al! tines that contain a '"#!* 
sian foltowmed by a run of any characters followed by another '#4 
sign. Such tines are reasonable candidates for being SYMPL comment 
fines. 


Lext_Patterns_and Reagylar_Exoressions 


This discussion introduces the notation for regular expressions 
used by FIND and the CHANGE procedure in the next section. The 
notation is terse but versatiles and has been applied in a number of 
pattern matching utilities. 


A text oeattern can be a simpte things tike the letter a or a 
more elaborate construct built up from simpte thingss tike the 
string format. To build arbitrary text patterns you need onty know 
a few rules. 


Any Literal chacacters» such as as is a text pattern that matches 
that same character in the text being scanned. A sequence of 
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literal characters like 7926 or grabho!td is ae pattern that 
matches any occurrence of that sequence of characters in a fine of 
the input. 


A pattern is said to match part of a text line if the text tine 
contains an occurrence of the pattern. For instance the pattern aa 

matches the tine aabc once at position ls» the line aabcaabc in 
two placess and the tine aaaa in three {(overiapping) places. 
Matching is done on a tine by tine basis 3 no pattern can match 
across atine boundary. Text patterns may be concatenated =: a text 
pattern followed by another text pattern forms a new pattern that 
matches anything matched by the firsts followed immediately by 
anything matched by the second. A sequence of ftiteral characters is 
an example of concatenated patterns. 


find has other capabilities - the ability to search for patterns 
that match classes of characterss that match patterns onty at 
particular positions on a tftines or that match text of indefinite 
fength. 


To be able to express these more general patternss we have to 
preempt some characters toe represent other types of text patternss 
or to delimit them. For examptes we use the character . asa 
text pattern that matches any singte character except a newline. 
The pattern Key matches xt+ys xays x?y and similar strings. 


The. and other reserved characters are often calted 
metachacascters. We try to choose characters which won*tt appear with 
high frequency in normal texts but still there are occasions when we 
want to took for a titeral occurrence of a metacharacter. Thus the 
special meaning of a metacharacter may be turned off by preceding it 
with the escape character @. Thus @e matches a ftiteral periods 
and aa matches a literal at sign. 


The metacharacter € signals that the characters followings up 
to the next J) form a character class» that is» a text pattern that 
matches any singie character from the bracketed liste For examples 
{aA} matches a or As [a-z]} matches any tower case fetter. 
There is a negated sharaster class» such that (”a-z]) matches any 
character except a tower case ftetters and so forth. Note that a 
negated character class never matches a newline. The escape 
convention can atso be used inside character classes if the 
character ctass is to contain ~ or - or @ or Je 


Two other metacharacters don't match tliteral characters but 
rather match positions on the input tinee “~* matches the beginning 
of a tine : “abe is a pattern that matches abe only if it appears 
as the first three characters of an input tine. Simitarlys 
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$ matches the newline at the end of a line : abcd 
matches abe only if it is the tast thing on a tine before the 
newline. Of course these can work together : “abc$ matches a tine 
that contains only abe» and “$ matches only empty tines (fines 
containing only a newline). 


Any of the text patterns aboye that match a singte character 
(everything but * and $) can be followed by the character * to 
make a text pattern which matches zero oft moce successive 
occurrences of the single character pattern. The resulting pattern 
jis calted a closure. For examples a*® matches zero or 
more a's; aa* matches one or more ats; (Ca-z3]* matches any 
string of zero or more lower case fietters. 


Since a closure matches zero or more instances of the patterns 
which do we pick if there's a choice? It turns out to be most 
convenient to match the longest possible string even when a null 
string match would be equally valid. Thus fa-zA-Z]* matches an 
entire word («which may be a null string)» La-zA-Z1]lfa-zA-Z1* matches 
an entire word (one or more fetters but not a null string)>s 
and .* matches a whole tine (which may be a null string). Any 
ambiguity in deciding which part of a tine matches a pattern is 
resolved by choosing the match beginning with the deftmost 
characters then choosing the Longest possible match at that point. 
So fCa-z}]La-z0-9]* matches the teftmost FORTRAN identifier on a 
lines (.*) matches anything between parenthesess and ee* matches 
an entire line of one ofr more characters (but not a tine containing 
onity a newline). 


Finallys no pattern matches across a fine boundary. This is 


often most natural and usefuls and it prevents an unwise .* from 
eating up an whote file. 
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14.20 TEXT MANIPULATION AND CONVERSION UTILITIES 
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Summacy_of Regular _Exeressions 


The previous discussion introduced a tot of new notation for 
matching text patterns and regular expressions. Here is a4 summary 
of what went before. 

c iitecal chacactec ( for example s ) 

° aQy character except newline 

beginning of Line 

$ end af Line ( null string before the newline } 

Ceol chatactec cslass {( any one of these characters ). for 
examples Cijkimn] matches the first character of a Fortran 
integer identifier. 

U"-e2e] negated shacastec class (all but these characters) 

* closure (zero or more occurrence of previous pattern) 

ac escaped sharacter (for examples 2%» O$» Af» a*) 


Any special meaning of characters in a text pattern is tost when 
escapeds inside a [eee] » or for : 


. not at beginning 
$ . mot at end 
* at beginning 


A character class consists of zero or more of the following 
elements» surrounded by € and Jj 3 
c fiteral characters including fC 
a~-c range of characters (digits» lower or upper case letters) 
negated character class if at beginning 


ac escaped character ( 9% a= aa a) ) 
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Special meaning of characters in a character class is lost when 
escaped or for 3 


not at beginning ( for example Ca”9jug] ) 
- at beginning or ends for exampte (€-#322] or ([+2zabce-} 
Note : the following three substitution patteros apptiy to the 


CHANGE utility described in the next section. A substitution 
pattern consists of zero or more of the fottowing elements 3: 


c literal character 
& dittos that iss whatever was matched 
c escaped character ( @& ) 


An eScape sequence consists of the character 2d followed by a 
single character 3 


an newline 
at tab 
ac c { inctuding a ) 


COMPANY PRIVATE 


. 14-35 
CDC - SOFTWARE ENGINEERING SERVICES 
7/30/8 
SES (Release wf) _Useris | Handbook WREVE AB 
14.0 TEXT MANIPULATION AND CONVERSION UTILITIES 
14. 19 CHANGE - CHANGE LINES | THAT | MATCH Wo PECIFIED PATTERNS 


PO RE 90 OE 28 Sn al Ce Be he Bi Be de Be ed had 


14.19 CHANGE_-_CHANGE_LINES_IHAL_MAICH SPECIEIED PATIERNS 


CHANGE changes patterns in a file. The from and to patterns may 
be specified on the controt statements or they may be given as the 
first two tines of an argument file. Both from and to must be 
specifieds gr a pattern file may be given via the with or using 
parameter. If none of these parameters are supplieds CHANGE takes 
its pattern argument from file input. Parameters to CHANGE are ° 


ior f 3: 
name of Input Eile which is to have its patterns changed. 


from : 
(optional) character string which reoresents the from string 
to be matched. 


to 


(optional) character string which represents the to 
substitution string. 


with or using 3: 
(optional) name of a file containing the from and to 
patterns on two separate lines. This file is used if there 
are tower case patterns in the from or to parameters which 
can't be entered via the control statement. 


onto or o 3 
(optional) name of file te receive the Qutput from CHANGE. 


If you don't code the o parameters the output appears on 
the File specified by the i parameter. 


Examptes of CHANGE Usage 


sesechange myfile from **£0-53** to *2MARK2=E* onto outfile 
* END CHANGE MYFILE -> OUTFILE 
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sesechange ofdfite using patfile 
* END CHANGE OLDFILE 


The first exampte shows CHANGE locating all lines that have an 
arbitrary number of digits between 0 and 5 at the beginning of the 
fines and changing the pattern so found into the string *=MARK=? 
Followed by the string of digits that was found. The second example 
shows CHANGE operating on a files where the pattern arguments are 
supplied via the argument file patfile. 
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14.20 XLIT_=.ITRANSLITERATE CHARACTERS 


XLIT transtiterates characters in a file. The from and to 
patterns may be specified on the control statements or they may be 
given as the first two tines of an argument file.» Both from and to 
must be specifieds or a pattern file may be given via the with = or 


using parameter. If none of these parameters are supplied XLIT 
takes its pattern argument from file input. Parameters to XLIT 
are 3 

ior f 3: 


name of Input Eile which is to have tts characters 
transliterated. 


from 3 
{optional) character string which represents the from string 
to be transtiterated. 


to 


we 


{optional) character string which represents the to 
transtiteration string. 


with or using ; 
(optional) name of a file containing the from and to 
patterns on two separate tines. This file is used if there 
are lower case characters in the from or to parameters 
which can't be entered via the control statement. 


onto or o : 
(optional) name of file to receive the Qutput from XLIT. 
If you don't code the o parameters the output appears on 
the file specified by the i parameter. 


Exampies of XLIT Usage 


sesextit myfilte from "ABCDE® to "VWXYZ* onto outfile 
* END XLIT MYFILE -> OUTFILE 
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sesexiit oldfiie using patfile 
* END XLIT OULDFILE 


Summacy_of_XLLI_Caeabilities 


This is a short summary of the facilities provided by XLIT. The 
examples odetow just show the from and to patterns. fhe simplest 
form of XLIT is to simply convert one character to anothers tike *: 

from x to y 


and have all occurrences of x in the input file be replaced 
by y¥ in the output file. Multiple transtations are also handy °: 


from xy to yx 


changes alt x's into y's and alftl yts into x's. There is also 
a nice shorthand notation 


from a-z to A-Z 
to transtate ali} flower case fetters to upper cases or 
from a~-zA-Z to A-Za-2z 
to do case reversal. Even good typists prefer 
A~Z a~zZ 
to 
ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijkimnopaqrstuvwxyz 
There are times when we would !ike to transiate awhote class of 
characters into just one characters and then to cotiapse runs of 
that transtation into just one instance. For examples transtating 


spacess tabs and newlines Into newlines and then collapsing multiple 
newlines leaves each of the words in a document on a separate tines 


ready for further processinge Or we might want to convert all 
alphabetic symbols in a program into a*s = and all numbers 
into n's. We specify this collapsing operation by giving a second 


argument that is shorter than the first : 
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from a-zA-Z to a 
fron 0-9 to n 


The imptication is that the tast character in the second argument 
(the to string) is to be replicated as often as necessary to make 
a string as tong as the first argument, and that this replicated 
character should never appear twice in succession in the output. 


xtit also provides an escape convention for writing tabs and 
newlines so that they are visible and cause a minimum of grief for 
programs that must inspect the arguments. We use the at-sign 92 as 
an escape character =: whatever character follows the escape 
character is in some way special. In particulars we define at to 
be a tab and @n to be a newlines so we can write : 


atan an 


to change all occurrences of "whitespace" (spacess tabs and 
newlines) to just one newline and leave one word per line, 
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1520 MISCELLANEOUS USEFUL GOODIES 


This section covers a number of useful SES procedures that fall 
into no other category than miscellaneous. The facilities in this 
section are described briefiy here. 


IAF sets up IAF terminal defaults for specific terminal types. 
OBJLIST displays CYBER 180 object text in a readable form. 


DO a "control! statement generator” that can optionally 
generate a batch job “on the fly". 


MATH a quick and dirty desk calculator 
BELL rings the bet! as an attention getter. 
BYE logs out your current interactive session. 


HEXOMP produces a hexadecimal dump of a (binary) file. 


CONC AT concatenates a tftist of files into a single files with the 
resulting file "packed" into a single “fogical record". 


SCATTER performs the reverse action of COLLECTs that is it 
"scatters™ a multi record file to a number of individual 
files. 
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15.1 TAE_=.SEL_UP_INITIAL_LAE_ TERMINAL PARAMETERS 


The IAF procedure defines your terminal to the NOS IAF facility. 
In additions it will notify you of MAILBOX messages» and updates to 
SES.INFO. 


There are defaults for alt the different terminal typess and 
normaitys the user only specifies his/her terminal type either on 
the proc call or in his/her PROFILE. Atti the strange parameters» 
including the terminal types may be set up in your profile. As an 
examples if you're togged in to a CDC 713 terminals you can set up 
the terminal controts by simp! y typing 3; 


seseiaf term=cdc713 


The tabte on the next page describes the parameters for IAFs the 
defaults,» and the profile variables that you can set to change the 
defaults chosen by the IAF procedure. 


Note =: white the IAF procedure is runnings do not hit carriage 
return (CR) to find out what's going ons even if it does seem a 
little stow. At the time of writings due to the way the NOS TRMDEF 
command workss hitting a carriage return interferes with the TRMDEF»s 
which will issue a line of garbfied data to your terminats and the 
TRMDEF command gets ignored. In other wordss the IAF procedure 
won't do anything. 
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ee oe ae 


device on your IST3s the 
defaults for ci and i> 
are changed to 50 each. 


+ + + + 
3 a 2 2 
fl a 3 FY 

Pacameter : Default + Peofile i Parameter H 
Name H Value ' Yaciable ; Usage : 

fea ee a a ne ae Sh a a a a ee a fone eee he ae a ee + 

$ terms t. ; No Default 3: term ; Tarawa type. For ai 

; H ; ? tist 3 of the terminal 3 

H H Hi ; types currently 3 

; ; ; i recognized by the IAF $ 

; ; ; 3} procedures, see the tist } 
H H : 3} at the end of this $ 
H ; H ; table. ; 
$a ee eee ee a re fae a ee ee fe a a ee ee ee eee + 
i intchrs ic + see below i intchr : char acter to INTERRUPT a 3 

3. H H : process. H 

$ eee ee eee ewe fee ee ee ee pe a ee eee a $ one + 

; eeeuckis tc $ see below H kérmene H shares tes ea "TERMINATE a 3 

H H H ; process. H 

+ A A AO SES ED SR Oe ES ee a ie a + AD UD Ee A A ES ee le ine 4 <P ONDER a Ate EN Hie ee ee ae + A AEA AUD ON ENN NOt SEND AN A EA ANE LAND DAD AIR AN “eam ei ee anmelden sa eee + 

; eeaches cc : see below ; canchr ; character to CANCEL as 

; ; ; $ line input at the } 

; H H ; terminal. : 

$ eee ween ee a ee ee oe $$ ew ee eee $e oe ee ee ee ee eee ee + 

: conchrs ct i: see below ; conchr ; eWacacter to use as a 3 

; H H ; CONTROL character when 3 

H H ; $; Qiving commands (such as $ 

H ; : $ page wait on or off) to } 

; H H $ the TIP. ; 

fe ee ee ee $e ewe we ee ee $e A ee a ae ce a a ee a a ee cn ae a tee a an ee 

:; hatf/futl : full : dupiex ? determines whether your ; 

; ; H ; terminal is to run in $ 

H : ; * HALF or FULL duptexe 

H ; ; 3 These are just keyse H 

$e ee een wm $e we we wee we $ ee ee ee $e ee eee meneame + 

3; ci 3; O ; ci :; Carriage return idie H 

H 3 ‘ + count for S73 or T1745. 3 

fone nee — poem eee eee ee $e ef ee ee ee eee + 

; ti ; 0 ; ti ; Line feed bdie count for $ 

; H H :; IST3 or TI745- : 

$e ee eee $e ee ee ee $b ee ca ee a oe $e ee ee ee ee + 

; hardcpy ; no ; wanideoy :; If you use a pueaeape H 
| . | : | 
a a * a s 
H H ; ; : 
+ + + + + 


The defaults given aboves namely "IAF default"s are those chosen 
by IAF (part of NOS)» as opposed to [AF (the SES procedure). We 
have copped out by not stating what they are heres since they change 
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from time to time. For a tist of the defaults» consult the IAF 
reference manuals or see your tocal NOS wizard. 


The term (for terminal) profile variable is set up when you use 
BLDPROF (BulLD PROFilte)s and the IAF procedure uses this profile 
variable. If you use the IAF procedure and no terminal type is 
specifieds either via the term parameter or the term profile 
variables IAF prompts for the terminal type. You can edit your 
profile to insert all the other defaults if you wish. 


Terminal types that the IAF procedure knows about at present 
are 3 


COC713»9 COC 751» CDC752» DX132A» NCR6209 T1745s9 TTY43s DECW3> 
TEK4014s IST3. 
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The tabte befow describes the control characters and other 
parameters that the IAF procedure establishes for youe Note = that 
a page width of zero (0) allows the maximum page width. 


$ mane nee toe en — $n e $m towne tee tem nee to--- = + 
 TERN- {CONTROL $ CANCEL { INTER- { TERM- {PAGE ! PAGE ‘SECHO- ! 
: INAL {= CHAR $ CHAR $ RUPT ¢ INATE {WIDTHS LENGTH $PLEX 3 
t TYPE $ CHAR $ CHAR} tMODE 
: $f oF $f € $F # $F #3 rn : 
$ nee wee a $e ee $n eee $e mene te-—-- fone te—ne-e + 
: : : : 
: CDC713 $ ESCAPE ? LINE {% STX  ¢ ETX ¢ O $ 16 ¢ FULL 3 
: : 2 CLEAR |! : : : 
: : 
tonne $e Stated See | aieateteatenteremes tenn n  astesieemeaneteted tome + 
; : : 
: CDOC751 } ESCAPE } GS 2 CTRL/P $ CTRL/T $ OF $ 24 $ FULL } 
: : : 
porn teen $—------= foe ene $e 5 ee ee $-——-- = + 
: : : : : : : 
: CDC752 } ESCAPE $ CTRL/X $ CTRLVP i CTRL/T $ 0 $ 24 $ FULL $ 
8 3 a a 4 2 a 2 3 
4 a a a a a a 3 a 
Sees $e ee ooo $om een = + meen ee $-—---- fone w= tonne 4+ 
: : : : : : : : 
$ DX132A $ % $$ CTRL/X  CTRL/VP 4 CTRLVT $132 $ 30 $ FULL $ 
a 3 a 3 s a s a % 
9 a a a 4 2 a a s 
$--  eteatenetenetented t——------- Seated ee tonnne fone toe + 
a a a 4 i] a ] % a 
3 | a s 8 | b] - a 
: NCR260 ! : : : : : 
: T1745 3 
1 TTY43  $ ESCAPE ? CTRL/X $ CTRL/P $ CTRLVT $ O ¢$ N/A # FULL 
t DECW3 : : : 
: TEK4014! : : 
: IST3 3 : : : : : 
t=--------  Seatentoeeetemenen fone e eee Se eo teeta tome nee toe-a---- + 


The default values can be changed by coding a parameter that 
corresponds with one of the columns marked with *. If half duplex 
is desireds simply code the half key. 


Note = when specifying an octal code to change a default values 
remember that the radixs enclosed in parenthesess must follow the 
numbers for example 3 

conchr =33(8) 
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Note : character values can be changed by entering the desired 
character enclosed in string quotes (apostrophes)»s instead of octal 
numbers. 
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1502 QBULIST.=_LIST CYBER 180 OBNECT TEXT 


OBJLIST prints out CYBER 180 object text in a readable form. 
Parameters to OBJLIST are ; 


ioor f 3 
(optional) name of Input Eile which is to have its contents 
listed out. If you don't code the i parameters OBJLIST 
assumes the object text is on file tgo. 


{optional) name of file to receive the Qutput from 
QBJLIST.» If you don't code the o parameters the output 
appears on file output. 


Examples of OBJLIST Usage 


ses,objlist o=fisting — 
* END OBJLIST LGD —-> LISTING 


seseobjlist izbinarys o=prinfy! 
* END OGBJLIST BINARY -> PRINFYL 
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1523 DO.=_ CONTROL STATEMENT. GENERATOR 


DO accepts a list of character stringss or a File of commands, 
and outputs them to the NOS controi statment stream. The stream of 
commands so generated may be submitted to the batch system if 
desired. For example 3: 


sesedo (*rewinds** stgetsmyfilets*disposesmyfilezpr's'tses.catiist?®) 
All sorts of NOS contro! statements may be given as parameter values 
to the DO procedure. Note that a perfectiy valid DO parameter value 
is a call on SES processor itseifs so that if you were feeling 
sufficiently playfuls you could code lines like : 
sesedo ‘sesedo **sesecatiist?*? 


Parameters to DO are 3 


Q 
1] 
ou 


(optional) list of Control Statements to be output to the 
control statement file. 


{optionat) name of file containing control statments to be 
executed. If you don't code the I parameters 0D orompts 
you to enter the statments from file input. Coding the i 
parameter causes 00 to submit a batch job containing the 
stream of commands from the file. 


(optional) name of Library in which the text record given 
by the & parameter may be found. The tibrary must have a 
directory. You use this feature to place canned streams of 
JCL (such as buiitd jobs) in a LIBEDIT style tibrary. See 
the Chapter 5 for hints on how to manage LIBEDIT 
libraries. 


un : 
{optionat) User Name in whose catalog the file given by the 
i parameters or the tibrary given by the 1? oarameter may be 
founds if it is not in the current user's catalog. 
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of 


f or file or files : 


(optional) tist of LOCAL FILES that are to be copied onto 
the end of the job file if DO is being used to create a 
batch job fone of the batchs batchn or defer keys are 
coded). If you code any values for the files parameters 
DG generates the job control to COPYBF each of the tocal 
files onto the end of the job file before SUBMITTING it 
and also generates the control statements in the jobfile 
itself that are necessary to COPYBF those files from INPUT 
when the job runs. If any of the filenames coded for the 
files parameter are not assigned to the job when you code 
the sesedo statements the D0 procedure aborts with an 
error messagee 


batch job parameters : 


These parameters are described in section 1.27 - "SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in tocai modes but it can be run in 
batch mode. The dayfite parameter is not used by this 
procedure. 


Example of Using DO to submit a batch job 


sesedo ('sesegencomp minctud*»s '"seseiswits ee 
*seseprint tisting’s "savestgo’)s batch; bye 


¥ 


10.23.2564 SUBMIT COMPLETE. JOBNAME IS ABLEBOD 


JOB DO SUBMITTED 


The four control statements (mostiy consisting of SES procedures 
course!) are built into a batch job and submitted. The bye 
procedure. then togs you off. 
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154 MATH =-_ INTERACTIVE KEYBOARD CALCULATOR 


MATH is an SES procedure that interacts with the user to provide 
a "quick and dirty™ interactive caiculator. OQniy integer arithmetic 
of 48 bits precision is provided. 


MATH works on the concept of the current variable» When MATH is 
starteds it starts with a variabie called VALUE» whose value is 0. 
Every time an expression is assigned to a variables that variable 
becomes the current variable. An assignment statement with no 
variable name on the teft of the operator assigns the expression to 
the current variable. Valid entries are ? 


= expression assigns the vatue of “expression” to the current 
variable. 


+ expression adds the value of “™expression"™ to the current 
variable. 


- expression subtracts the value of "expression" from the 
current variable. 


* expression multiplies the current variable by the valiue of 
"expression®™ and assigns the resuft to the 
current variable. 


/ expression divides the current variable by the vatue of 
"expression" and assigns the resuit to the 
current variable. 


4/ expression performs the calcutation current variable MODULO 
“expression” and assigns the result to the 
current variable. 


** expression raises the current variabie to the power 
“exoressian"™ and assigns the result to the 
current variabte. 


name = expression assigns the value of “expression” to the variable 


specified by “"name"» which then becomes” the 
current variable. 
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15.5 BELL =_ATTENTION GETTER OR _ WAKE UP 


BELL is a useful facility for those users who fall asiteep at the 
terminal. This BELL procedure "rings the belt" a specified number 
of tines. Parameters to BELL are 3 


is the (optional) number of times to “ring the belt". If 
you don't code the n parameters BELL rings twice. 


COMPANY PRIVATE 


15-12 
CDC ~ SOFTWARE ENGINEERING SERVICES 
7130/8 
15.0 MISCELLANEOUS USEFUL GOODIES 
15.6 BYE — LOG OUT 


1566 BYE.=_L0G_0UT 


BYE is an SES procedure that sends a special control code to the 
user's terminals to fog it out. This provides the useful facility 
that you can set a stream of SES procedures goings with the last one 
being BYE» and you can then walk away from the terminal and tet the 
system get on with the job. For examples the Following is a fairty 
typical sequence : 


ses.egencomp themod!i; cybil; print listing; *savesigo’; bye 


The example shown GENerates a COMPile fite for module themodt, 
compiles it with the CYBIL compilers PRINTS the tisting output of 
the compilers saves the binary output of the compiter on file tgo»s 
and finally tlogs the terminal off via the BYE procedure. The 
programmer is able to type that tine of SES procedure caliss then go 
and have tea while it's all happening. 
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15-7 HEXDMP_=_ GENERATE _HEXADECIMAL DUMP 


HEXDMP produces a printable dump of a binary file. In the dump, 
CYBER words (addressed in octal) are shown in hexadecimal with 8/12 
ASCII interpretation. Parameters to HEXDMP are 3: 


i 3 
name of the tocal fite from which to produce the dump. 
o: 
name to be used for the tocal file containing the 
printable dump. 
p or t 3 
(optional) type of dump to produce 3 
P printable - 8 words per fine for tine printer 
T terminal - 4 words per tJine for terminal output 
(default) 
aor h 2. 


these (optional) keys determine if ASCII interpretation of 
the dump is to be inctuded in the output. If you code the 
a keys ASCII is included - this is the default action. If 
you code the h key (Hex onty) key» ASCII is not inctuded in 
the dump. 


Example of HEXDMP Usage 


sesehexdmp filel tlist t 


* FILE DUMP COMPLETE 


This command creates a file "TLIST’ suitable for displaying on a 
terminal showing the contents of file "FILE1!' in hexadecimal. 
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15.8 CONCAT. =_CONCATENATE_EILES 


CONCAT concatenates files onto ae single “group™ file. It is 
similar to COLLECT except that CONCAT works with files instead of 
recordss and the resultant group File is PACKed upon completion of 
the process. Parameters to CONCAT are 3: 


§oor f 3 
is a Fist of names of files to be concatenated onto the 
group file. 


g or group 3. 
(optional) name of group file to receive the final 
concatenated set of files. If you don't code the group 
parameters CONCAT uses the value of profile variable group 
» and if there's no such variabie defineds uses the name 
group. 


msg or nomsg ? 
these {ootional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 


Exampies of CONCAT Usage 


seseconcat (myfileshisfilesanyfite) 

* MYFILE -> GROUP 

* HISFILE => GROUP 

* ANYFILE => GROUP 

* END CONCAT MYFILEeeANYFILE -> GROUP 


seseconcat (grabshotdsgripsciutch)? g=titefins nomsg 
* END CONCAT GRABee-CLUTCH => TITEFIN 
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1549 SCATTER =_SCATTER_A_MULTI_RECORD_ FILE _TO_OTHER_EFILES 


SCATTER copies the records of a multi record file to a number of 
other files. Parameters to SCATTER are : 


moor f 2. 
fist of names of Eiles or Member files to which the records 
of the singte file are to be copied. Names may apoear in 
the tist more than once» if you want to divert sundry 
records to the same file. 


g ot group : 
(optional) name of GROUP file containing the records to be 
copied. If you don't code the g parameters SCATTER uses 
the walue of profile variable groups and if there's no such 
variabie defineds uses the file name group. 


if you code this (optional) keys SCATTER does got rewind 
the group file before starting the copy sequence. If you 
don't code the nr keys» SCATTER rewinds the group file 
before doing any copying. 


Examptes of SCATTER Usage 


sesecataiog newprox 

~—GETPXDB. TEXT TOOLDOC.. TEXT GETMAIL.-eTEXT COMPARE. TEXT 
GENCORS TEXT GENREVB. e TEXT CPAS180¢-TEXT 

* END CATALOG NEWPROX 

sesescatter (cerbicsvarnelstaviotscerbicsvarnelscerbicsfootlielscrsece 
eo? g=newpr ox 

ss END SCATTER CERBIC.~-FOOTLE <—- NEWPROX 

sesecatatog cerbic 

GETPXDBee TEXT COMPARE.-TEXT GENREVBee TEXT 

*. END CATALOG CERBIC 

sesecataiog varnel 

TOOLDOC..TEXT GENCORS. e TEXT 

* END CATALOG VARNEL 
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The example shows how SCATTER is used to separate the records 
from the file newprox onto the different files given in the Jist on 
the SCATTER calle The CATALOG procedures are used here to show the 
"“hefore and after" effect of SCATTER. 
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16-0 HANDLING UPDATE PROGRAM LIBRARIES 


For those who use UPDATE as the source text maintenance regime 
for software developments the set of SES procedures described below 
supply a fairly easy to use interface to UPDATE} A short summary of 
these SES procedures appears firsts with the more detailed 
descriptions following. The SES procedures to drive UPDATE are as 
follows : 


GENUPCF GENerate UPdate Compile Eile. Generates a compile fite 
for specified decks with modsets optionally applied. 
Either a Quick mode or Full mode UPDATE can be 
performed. 


GENUPSF GENerate YPdate Source Ejite. A source file may be 
generated for specific decks or common deckss with 
modsets optionalty applied. 


GETDECK GET DECK s) for editing. This is intended as a 
preliminary te a GENMOD(S) procedure usage in order to 
generate nodsets. 


GENMOD(S) GENerate MODification Sets for decks on a PL. GENMODS 
uses the SCOOP utility to comoare two files and generate 
UPDATE modification directives. 


UPDATE apolies a tist of modsets to an ofd program tibrary and 
creates'a new program ftibrary. 
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PROEILE VacLable for_ UPDATE Eacilities 


The update procedure interfaces use onty three profile variables» 
but these are of great utility when you're working on the same PL 
for tong intervaits. The profile variables are : 


oldpt name of the program Jibrary to be used when generating 
compite filess edit files and so one It is the default for 
the pl or otdpli parameter on the procedures. 


newp i name of a new program tfibrary when running the UPDATE 
procedures It is the default for 
the npti or newpl parameter on the UPDATE procedure. 


plowner PL QWNER Is the user name of the catatog in which the 
program fibrary resides. It is the defauit § for 
the un parameter on all the procedures. 


updtmce UPDaIe Master Control Character. If you're working with 
such things as ‘stash PL'*#¥st»s this profile variabte is 
useful for overriding the standard master control character 
which is the asterisk (*) character. 
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Working with the UPDATE Procedures 


In order to get the best use out of the UPDATE interface 
facilitiess it is anticipated that users will follow the set of 
working procedures outiined betow. 


o Most of the procedures work on the concept of applying modsets 
to an existing program tibrarys and only making a new program 
library at fairly infrequent intervalss say once every two 
weeks ofr SO-« This allows many peopte to be working on 
unconnected decks at a times with one person controtiing the 
building of new program libraries. 


o To make modifications to a decks use GETDECK to generate an 
EDIT FILE (plus a COMPILE FILE)5 edit the edit files then use 
GENMOD(S) to generate modsets which can then be used in 
subsequent GENUPCF runs. 


o To make major changes to decks» use GENUPSF to get the source 
of the deck outs and edit that. 


The working scheme suggested here has been in uses successfull ys 
for some time. It is far easier to comprehend and handie than it is 
to be manually’ creating correction sets. Pictorialliys the scheme 
looks something tike this : 
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e 
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ee 
/ He H 
fees want § NEW 
; $orocwennnmnm=- COMPILE <---> 
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To show how this goes in practices on the next page there's an 
example of a complete session of work involtving the three widely 
used procedures GETDECKs GENMOD(S) and GENUPCF. We want to generate 
modsets for decks “delta™s and "mu" through "phi™. User typing is 
i'n lower cases and NOS messages in UPPER CASE. It is assumed that 
the program ftibrary - PROSLIB - is specified in your profile. 
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sesegetdeck dz=({deltasmu.ephi) 

* GENERATING COMPILE FILE COMPILE 

* GENERATING EDIT FILE EDTFILE 

a END GETDECK EDTFILEs COMPILE <— PROGLIB 


editsedtfile 
e022 
editing 
session 


EDITsEDTFILE 


sesegenmods anymods jan0879 cdz(delitasmuse-ephi) 
* END GENMOD COMPILEZEDTFILE => ANYMODS 


sesegenupcf anymods 
*. GENERATING COMPILE FILE COMPILE 
* END GENUPCF COMPILE <- PROGLIB 


As you can see from the examptes the amount of typing you do is 
smalits there. are in fact oniy four commands {excluding the actual 
edit session commands)» the system does the rest. 
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16.1 GENUPCE_=_GENERATE_ UPDATE _ COMPILE _EILE 


GENUPCF generates a compile file for any specified decks on an 
UPDATE program library. Modsets can be appiied also Parameters to 
GENUPCF are 3: 


m or mods : 
is an (optional) list of names of files containing modsets 
to be apptied against the PL when generating the compite 
file. fne or both of the mods oarameter and the d 
parameter must be specified. 


door all: 
is an Coptional) list of deck names to be piaced on the 
compite file. If the alt key Is codeds this Implies a full 
update in which case no deck names should be specified. 
One or both of the mods and the 4d parameter gust be 
specified. 


{optional) name of the file to receive the (Compite Eite. 
If you don't code this parameters the compile file appears 
on a file calted compile. 


pi or oldpl 3: 
(optional) name of the UPDATE program library from which to 
generate the compile file. If you don't code the pf 
parameters, GENUPCF uses the value of profile variable ofdplt 
as the name of the program librarys and if there's no such 
profile variable defineds uses the name ofdpt. 


{optional) name of user in whose catalog the program 
fibrary resides. If you don’t code the un parameters 
GENUPCF uses the value of oprofite variable plowner (PL 
OWNER) as you names and if there*s no such profile variabte 
defineds GENUPCF uses the name of the current user. 


status or sts : 
is the (optional) name of a job control register to receive 
the status of the process. This parameter is of use when 
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GENUPCF is being used as a building biock of ae targer 
procedure. Status must be one of Rls R2s R3 or EFs The 
specified register is set to zero (0) in the event of a 
successful completions and to non zero If the UPDATE 
process bombs for any reason. 


nomsg ; 
these foptional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 ~- "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 


coding this (optional) key specifies that UPDATE errors do 
not abort the procedure. nodrop is useful where GENUPCF is 
used as a building block of ftarger procedures or jobs. 


{optional) Master Character to be used instead of the 
standard master character (*). If you don't code the ame 
parameter, GENUPCF uses the value of profile variable 
updtmces and if there's no such profile variables uses the 
default master character asterisk (*). 


Examples of GENUPCF Usage 


sesegenupcf smodfile 
GENERATING COMPILE FILE COMPILE 
END GENUPCF COMPILE <—- MOLDPL 


* 
* 


sesegenupcf m=z=(modslomods2)s d=(alidigswhilessdefines)»s pizanyp! 
GENERATING COMPILE FILE XPANDED 
END GENUPCF XPANDED <= ANYPL 


*. 


* 


The first example shows the simplest usage of GENUPCF to generate 
the default compile file compile from a source program tibrary 
called moidpi (Master QLDPL) whose name ts presumably defined in the 
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user's profile. The compile file is generated by applying the 
modsets in the file modfite. 


The second examopite shows a slightly more complicated situation 
where you is applying a tist of modsets and specifying a tist of 
decks to be placed on a compite File called xpanded. The compite 
file is to come from a source program tibrary calted anyplt. 
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16.2 GETDECK =_GET_DECK(S)_FOR_EDITING 


GETDECK ts used to produce two files from an UPDATE program 
library : a compile file with sequence numbers and an edit fite 
without sequence numbers. The edit file is altered using an editor 
or suchtike. The two files can then be used as inputs to GENMOD(S) 
to produce UPDATE correction sets. Parameters to GETDECK are 3: 


moor mods * 
is an (optional) tist of names of files containing modsets 
to be applied against the PL when generating the compile 
and edit files. One or both of the mods parameter and the 
d parameter pust be specified. 


d or decks or c or coms or all : 
is an (optional) tist of deck or common deck names to be 
placed on the compile and edit files. If the alt key is 
codeds this implies a full update In which case no deck 
Names should be specified. One or both of the mods and the 
d parameter and the mods parameter must be specified. 


ef 3 
(optional) name of the file to receive the Edit Eite. If 
you don*t code this parameters the edit file appears on a 
File called edtfile. 


pi or otdpl 3: 
(optional) name of the UPDATE program tibrary from which to 
generate the compile file. If you don't code the pl 
parameters GETDECK uses the value of profile variable oltdpl 
as the name of the program library» and if there's no such 
profile variable defineds uses the name oldplt. 


un 3 
(optionait) name of user in whose catalog the program 
library resides. If you don't code the un parameter» 
GETDECK uses the value of profite variable plowner (PL 
OWNER) as you names and if there's no such profile variable 
defineds GETDECK uses the name of the current user. 

cf : 


{optionat) name of the file to receive the compite file. 
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status 


msg or 


nodrop 


If you don't code this parameters the compite file apoears 
on a file called compile. 


or sts : 

is the (optional) name of a job control register to receive 
the status of the process. This parameter is of use when 
GETDECK is being used as a building block of a targer 
procedure. Status must be one of Rls R2» R3 or EF- The 
specified register is set to zero (0) in the event of a 
successful completions and to non zero if the UPDATE 
process bombs for any reason. 


nomsg 3. 
these (optional) keys contro! the generation of 
informative messages by this procedure and are fully 
described in section 1.8 ~ "INFORMATIVE MESSAGES FROM SES 
PROCEDURES®,. 


3 
coding this Coptional) key specifies that UPDATE errors do 
not abort the procedure. nodrop is useful where GENUPSF is 
used as a building block of larger procedures or jobs. 


(optional) Master Character to be used instead of the 
standard master character (*). If you don*t code the mc. 
Parameters GENUPSF uses the value of profile variable 
updtmccs and if there's no such profile variables uses the 
default master character asterisk (*). 


Example of GETDECK Usage 


sesegetdeck (fistsofstodayssmodsetsstosapplysagainststhesp!) 
* GENERATING COMPILE FILE COMPILE 

* GENERATING EDIT FILE EDTFILE 

* END GETDECK EDTFILEs COMPILE <- SOLDPL 


This exampie shows a whole raft of modsets applied to a program 


fibrary 


whose name you defined as SOLOPL (Super QLDPL) in the 
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profile. The compite file and edit file names take their defaults 
of compite and edtfilte. The edit file edtfite may now be edited to 
provide a basis for a GENMOD(S) run to generate some more modsets. 
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16.3 GENMO0(5)_=_GENERATE MODSETS_EOQR_ UPDATE 


GENMOD(S) uses the SCONP utility to compare two files - a new 
file and an old compifte file with sequence numbers - and produce an 
UPDATE correction set which can subsequently be used by the other 
UPDATE interface procedures» Parameters to GENMOQD(S) are ;3 


m or mods 3. 
{optional) name of file to receive the generated modsets. 
If you dontt code the m parameters GENMOD(S) places the 
generated modsets on a file caited modsets. 


for id or ident : 
{optional) name of the IDENT to appear as the first fine of 
the generated modsets. If you don't code the ident 
parameters the ident name defaults to that of the File 
specified by the m parameter. 


c or cd ? 
(optional) Compile Qirectives are the name(s) of deck{s)} to 
be compited when the modsets are eventualiy appiied in a 
compile file generation. Ranges of decks may be 
specified. 


nh or new 3 
(optional) name of the NEW file (the edited file without 
sequence idents). If you don't code the new parameters 
GENMOD(S) uses edtfiles which is the default edit file name 
generated by GETDECK. 


o or old : 
(optional) name of the OLD file (compile file with sequence 
idents). If you don't code the ofd parameters» GENMOD(S) 
uses compites which is the default compite file name 
generated by GETDECK. 


mc 3 ; 
(optional) Master Character to be used instead of the 
standard master character (*). If you don't code the mec 
parameters GENMOGD(S) uses the value of profile variable 
updtmccs and if there's no such profile variables uses the 
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default master character asterisk (*),. 


Exampies of GENMOD(S) Usage | 


sesegenmnods mzetoday id=jan08 cd=(deckasdektiast) 
* END GENMGDS COMPILE:SEDTFILE -> TODAY 


ses.egenmods tuesday jan09 newzgood old=broken 
¥ END GENMODS BROKEN:GO0D -> TUESDAY 
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16.4 GENUPSE_=_ GENERATE UPDATE SOURCE FILE 


GENUPSF generates a source fite for any specified decks on an 
UPDATE program library. Modsets can be applied aiso.e Parameters to 
GENUPSF are 3 


moor mods : 
is an (optional) tist of names of files containing modsets 
to be applied against the PL when generating the source 
file. One or both of the mods parameter and the d 
parameter must be specified. 


d or decks or 

c or coms or 

alideck or allcom : 
is an (optional) list of the things to be placed on the 
source file. door decks is a list of DECKS to be placed on 
the source filte. coor coms is a fist of COMMON DECKS to be 
placed on the source file. Coding the altdeck or the 
allcom keys indicates that a full mode update if to be 
performeds in which case no deck names should be soecified 
« Qne or both of the mods and the decks parameter myst be 
specified. 


(optional) name of the file to receive the Source Eile. If 
you don't code this parameters the source file appears on a 
File called source. 


p! or otdp!t : 
{optionai) name of the UPDATE program !fibrary from which to 
generate the source file. If you don*t code the pl 
parameters GENUPSF uses the vatue of profile variable ofdp! 
as the name of the program tibrarys and if there's no such 
profite variable defineds uses the name oldpl. 


ee 


un 
(optional) name of user in whose catalog the program 
library resides. If you dontt code the un parameters 
GENUPSF uses the vatue of profile variable ptowner {PL 
OWNER) as you names and if there's no such profile variable 
defineds GENUPSF uses the name of the current user. 
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status 


msg or 


nodrop 


mc : 


or sts 3 

is the (optional) name of a job contro! register to receive 
the status of the process. This parameter is of use when 
GENUPSF is being used as a buiitding block of a farger 
procedure. Status must be one of Rl» R2» R3 or EF. The 
specified register is set to zero (0) in the event of a 
successful completions and to non zero if the UPDATE 
process bombs for any reasons 


nomsg : 
these f{optional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - “INFORMATIVE MESSAGES FROM SES 
PROCEDURES", 


coding this (optional) key specifies that UPDATE errors do 
not abort the procedure. nodrop is useful where GETDECK(S) 
is used as a building block of targer procedures or jobs. 


{optional) Master Character to be used instead of the 
standard master character (*). If you dontft code the me 
parameters GETDECKIS) uses the vaiue of profile variable 
updtmcc,s, and if there's no such profile variables uses the 
default master character asterisk (#*). 


Examples of GENUPSF Usage 


sesegenupsf cz*git$mcs's pizmcsplis unz je j0102 
* GENERATING SQURCE FILE SGURCE 
* END GENUPSF SOURCE <= MCSPL 


sesegenupsf (modsonesmodstwo)s dzdeckoneeedecktwos sznewfile 
* GENERATING SOURCE FILE NEWFILE 
* END GENUPSF NEWFILE <= OLDPL 


The first example shows GENUPSF used to place a common deck onto 
the source file (which defaults to source since it wasnt 
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specified). Note the use of string delimiters  () because the 
common deck name git$mcecs has a $ Sign in it. Also in thts 
exampie both the program iibrary name and you name where it is to be 
found are specified. 


The second example shows a pair of modsets being applied to the 
program tibrary calied otdpi in order to generate a source file for 
a range of decks deckone thru decktwos with the source file 
appearing on a file called newfile. 
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16.5 UPDATE _=_UPDATE PROGRAM LIBRARY WITH CORRECTION SETS) 


UPDATE applies a fist of modsets against an ofd program library 
to produce a new orogram library in UPDATE format. The old and new 
program library names can be the sames in which case the old program 
library is rewritten. Note : that program tibrary creation is the 
only function performed by this UPDATE procedure - simultaneous 
compifte file generation is not done.» Parameters to UPDATE are 3: 


mods or m 3 
jist of one or more file(s) containing the WMODiIfication 
Set(s) to be apptiied against the program library specified 
by the pl parameter. 


ploor ofdpt :. 
(optional!) name of OLD Program Library to be updated from 
the correction set file. If you don't code the pl 
parameters UPDATE uses the value of profile variable ofdpi 
as the name of the program tlibrarys and if there's no such 
variable defineds UPDATE uses the defauit name oldpi. 


npfi or newp! : 

(optional) name of New Program Library to be created when 
the update has been completed.» If you don't code the npl 
parameters UPDATE uses the vatue of profile variable newpt 
as the name of the new program librarys and if there's no 
such variable defineds UPDATE writes the new program 
library over the old program tibrary specified by the pl 
parameter. 


un 3 
(optional) User Name in whose catalog the program tfibrary 
specified by pi/npl is to be founds if pi/np! is not in the 
catalog of the current user. If you don*t code the un 
parameters UPDATE uses the vatue of profile variabie 
plowner as the user name from whose catalog the program 
library is to be obtaineds and if there's no such variable 
defineds UPDATE uses the current user's cataiog. 


fock or notlock : 
these (optional) parameters determine whether the program 
Jibrary update process is interlocked against simultaneous 
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status 


msg or 


updates}; coding a filename for the lock parameter 
determines the name of the interlock file. Interiocking is 
the default action when the program library being updated 
is itn another user's catatog. If you don*t code either of 
the flock or nolock keyss interlocking is controlled by the 
lokmode profile variabie. Refer to the introductory 
sections of this chapter for information on the 
interactions of the fokmode profile variable and the lock 
and nolock parameters. If you don't code a filename (for 
the fock parameters the contents of profile variable 
intriok is used as the interlock filename; if there's no 
such profile variables the name intrilok is used as the tock 
filename. The interlock file must be in the same catalog 
as the program tibrary being updated. If the interlock 
file cannot be founds the procedure aborts. 


or sts : 

is the foptional) name of a job control register to receive 
the status of the process. This parameter is of use when 
UPDATE is being used as a building btock of a targer 
procedures Status must be one of Rl» R2s R3 or EF. The 
specified register is set to zero (0) in the event of a 
successful compietions and to non zero if the UPDATE 
process bombs for any reason. 


nomsg : 

these (optional) keys contro! the generation of informative 
messages by this procedure and are fully described in 
section 1.8 —- "INFORMATIVE MESSAGES FROM SES PROCEDURES”. 


(optional) Master Character to be used instead of the 
standard master character (*). If you don't code the me 
parameters, UPDATE uses the vatue of profite variable 
updtmccs and if there's no such profile variables uses the 
default master character asterisk (*), 
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Example of UPDATE Usage 
seseupdate (mondaystuesdaysfriday)s pl=coboipi 
* APPLYING MONDAY.-FRIDAY TO COBOLPL 
* NEW LIBRARY ON SESTMPL 
* NEW LIBRARY NOW ON COBOLPL 
* SESTMPL PURGED 
* END UPDATE COBOLPL 
This example shows a tist of modifications in files mondays 


thursday and friday appiied against the cobotp! program library. 
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17.0 STRUCTURED PROCESS TOOLS 


CAO3_=_ COMPUTER _ AIDED DESIGN QE SOFTWARE 


The structured process tools are ae set of Data Dictionary 
utilities and a Computer Graphics Design tool. They support the 
Structured Analysis/Structured Design (SASD) methodology used for 
development of software. 


CADSG creates or updates DFD» SCT and DSD diagrams used in the 
SASD methodology. 


CADSGUT tists or edits diagram titie blocks. 
DDCREAT creates a data dictionary. 
DDDIS displays the contents of a data dictionary. 


DDOMERGE merges the contents of two data dictionaries into a singte 
data dictionary. 


DDOXREF prepares across reference ftisting of a data dictionary. 


DOXCHK checks a data dictionary for consistency. 
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The Computer Graphics Diagram tool supports the Data Fiow Diagram 
(DFO), Structure Charts (SCT) and Data Structure Diagram (05D). 
These diagrams can be createds printeds saveds recatied and updated 
using a TEKTRONIX 4014 or IST-III Graphics Terminal. Other 
terminalis will be supported in tater versions. See the "Applicable 
Documents” section of this document for the manual that supports the 
CADS Graphics. 


The Data Dictionary Utilities provide a set of creations 
updatings checking and printing functions. Version 1.22 consists of 
CREATEs DISPLAYs MERGEs XCHECK and XREF functions. Later versions 
will also contain an EDIT functione See the "Applicable Documents" 
section of this document for the manual that supports the Data 
Dictionary. 
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17.1 CADSG_~_CREATE_OR_ UPDATE SASD_ DIAGRAMS 


The CADS Graphics tools» CADSGs» supports the creation and 
maintenance of Data Flow Diagrams (DFD)s Data Structure Diagrams 
(08D) and Structure Charts (SCT). These diagrams are the primary 
diagrams used in the SASD technique. See the SASD GRAPHICS USER'*S 
HANDBODKs ARH3981ls for detaiis of this too!. Parameters to CADSG 
are $: 


ntbk 3 
{ootionalt) name of the file to be used as the current 
notebook. If you don't code this parameters CADSG uses the 
value of the profile variable ntbk»s and if there's no such 
variabte defined in your profites then CADSG uses the 
filename NOTEBK. 


newntbk 3. 
(optional) name of the file to be used as the new 
notebook, If you don't code this parameters CADSG writes 
the notebook back to the current notebook file {see ntbk 
parameter). 


term 3 . 
(optional) name of your terminal types TEK4014 or IST3. If 
you don't code this parameters» CADSG uses the value of the 
profile variable terms and if there's no such variable 
defined in your profiles then CADSG wilt ask you which 
terminal type you have. 


baud : 
(optional) baud rate you are running with your terminal. 
If you don't code this parameters CADSG uses the profile 
variable bauds and if there's no such variabie defined in 
your profiles then CADSG will ask you for your baud rate. 


hardcpy : 
(optional) do you have a hardcopy device attached to your 
terminal? YES» NOs Y or Ne If you don't code this 
parameters CADSG uses the profile variabie hardcpys and if 
there's no such variabte defined in your profiles then 
CADSG will ask you if you have a hardcopy device. 
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egm : 
(TEK4014 ontlys optional) do you have the Extended Graphics 
Modules EGMs on your TEKTRONIX 4014 terminal? YESs NOs Y 
or Ne If you. don't code this parameter for the TEK4014» 
CAODSG uses the profite variable egms and if there's no such 
variable defined in your profiles the CADSG wil! ask you if 
you have EGM. 


sync 3 
{TEK4014 onty»s optional) are you running synchronous or 
asynchronous? A or Se. If you don't code this parameter 
for the TEK4014s CADSG uses the profitie variable syne» and 
if there*s no such variable defined in your profiles then 
CADSG will ask you which you are running. 


New Notebook 
If the file name does not exist or is emotys anew notebook iis 
created. Use the NEW command within CADSG (see SASD GRAPHICS 
USER'S HANDBOOK ARH3981). 
Examples of CADSG Usage 


SES-CADSGsNTBK=MYBO0Ks NEWNTBK*MYNEWBK 
* BEGINNING CADSG GN MYBOOK 


( Interactive session with CADSG ) 


* END CADSG NOTEBOOK MYBOOK --> MYNEWBK 
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17.2 CAQSGUT =_LIST OR EDIT _DIAGRAM_TIILE BLOCKS 


The CADSGUT SES procedure for R1.2 provides a utility for 
complete or partial tlisting of the notebook file diagram tittle 
blocks and/or replacement of fieids within these tities. 


The call format is: 


SES»*CADSGUTsnt bk=pfnlsnewntbk=pfn2sLlIST 


ntbk 3: 
foptional) name of the file containing the diagram 
records. If this vaiue is not specifieds the procedures 
will use the vatue of orofile variable ntbk as the input 
file name. If no variable is defined» CADSGUT uses the 
name NOTEBK as the name of the input diagram file. 


newntbk 3 
{optional) name of the file to which the edited and/or 
converted diagram records are written. If this vwariabie is 
not specifieds CADSGUT uses the default name NEWNTSK as the 
name of the output file. 


fist : 
If tist tloptional) is specifieds, CADSGUT performs an 
SESePRINT of the complete diagram titie information from 
ali diagram records contained on the input file. 
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1723 DOCREAT.=_CREATE_A_DATA_DICTIONARY 


The DDCREAT function takes a user text input file and creates a 
Data Dictionary (DD) file. Parameters to DDCREAT are :? 


sos 
Coptional) name of the file containing the source data for 
creating the DO. If you dontt code the i parameters then 
DOCREAT uses the value of the profite variable ddis and if 
there*s no such variable defined in your profiles then 
DDOCREAT uses the filename DDTEXT. The i file is not 
rewound. 

new 3 


(optional) name of the file onto which the new DD is to be 
written. If you don't code the new parameters then DDCREAT 
uses the vatue of the profile variable ddnews and if 
there's no such variable defined itn your profiles then 
DBOCREAT uses the file name NEWDD. 


Exampie of DDCREAT Usage 
SES-DOCREAT I*MYTEXTs NEW=MYNEWDD 
* BEGINNING DD CREATE 


( Additional informative messages from DDCREAT }) 
* END DD DDCREAT MYTEXT ~---> MYNEWDD 


This example shows DDCREAT used to create a new data dictionarys 
MYNEWDD, from the text in the source file MYTEXT. 
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17-4 DDQLS_-_QLSPLAY_A_DATA_DICTIONARY 


The ODDIS function extracts entries from a data dictionary and 
writes them to an output text file. Extraction criteria are 
specified by directives on a directives file or by specifying a type 
key. (See Data Dictionary User's Handbook ARH39860.) Parameters to 
DDDES are : 


oid : 
(optional) name of an old data dictionary file from which 
to display a text file. If you don't code this parameters 
then DODIS uses the value of the profile variable ddotd»s 
and if there's no such variable defined in your profiles 
then DDDIS uses the filename OLDOD. 


(optional) name of the file to receive the output from 
DDODIS in a form suitable for inclusion as 'asis* text in a 
FORMATted document. If you dontt code this parameters then 
DODIS uses the value of the profile variable ddo»s and =if 
there's no such variabte defined in your profiles then 
DDODIS uses the filename DOTEXT. 


a. 
oe 


{optional) name of the file containing directivess in NOS 
ASCII line-image formats to the DDDIS processor. If you 
don't code this parameters DDDIS uses the vatue of the 
profile variabite ddd.» If there's no such profile variable 
defined in your profile and a type key is not specifieds 
then DDDIS accepts directives from your terminal ors in the 
case of a batch jobs from the filename input. The d file 
is not rewound. If you code the d parameters don't code a 
type key. 


type ;: 

(optional) key specifies a DDDIS directive keywords 
Acceptable vatues for type are: alls alths datas file» 
fiows compones element» processs oprochs modules actions 
actionhs dfds dfdhs scts notypes and undef; don*t include a 
backslash. Coding the type parameter is equivalent to 
specifying the directives "\ keyword \end™ on a qd 
(directives) file. If you code the type parameters dontt 
code the d parameter. 


COMPANY PRIVATE 


ou aa 


17-8 
CDC ~— SOFTWARE ENGINEERING SERVICES 
743078 
17.0 STRUCTURED PROCESS TOOLS 
1724, 00018 ~ DISPLAY A DATA DICTIONARY 


print : 

(optional) parameter to control the PRINTing of the outputs 
o file. When the job runs in batch mode and there is no 0 
files one copy is printed automatically. If you run the 
procedure in focal modes no copies are printed unless you 
specificaliy code some print parameter. For examples you 
code print=c=3 to obtain three copies of the parameter o 
file. The format of the print parameter is that of the 
parameters for the PRINT procedure. 


Example of DDDIS Usage 


SESeDDDIS» OLD=MYOLDODs O=LISTITs D=DOWHAT 
* BEGINNING DD DISPLAY 
*. DD DISPLAY ACCEPTING DIRECTIVES 


{ Additional 00 / User Interaction ) 


* END DD DDDIS MYOQLDDD ----> LISTIT 


This example shows DDDIS used to display seltected entries from the 
data dictionarys MYOLDOD. The directives for selecting entries were 
read from the fite DOWHAT. If this parameter had been omitted» 
directives would hawe been read from the file INPUT. The listing. of 
formatted data dictionary entries was written to the file LISTIT in 
the order selected by the directives read from the file DOWHAT. 
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17-5 DDMERGE.=_ MERGE L¥O_OATA_DICTLONARBIES 


The ODMERGE function combines two data dictionaries to produce a 
New one. Parameters to DDMERGE are : 


old : 
{optional) name of the ofd data dictionary file with which 
you wish to merge another data dictionary. If you don*t 
code the ofd parameters then DOMERGE uses the vaiue of the 
profifte variabte ddold» and if there's no such variable 
defined in your profiles then DDMERGE uses the filename 


DLDOD. 

m3 
{optional) name of the data dictionary file you wish to 
merge with the old data dictionary. If you don*t code the 
m parameters DOMERGE uses the value of the profite variable 
ddm» and if there's no such variable defined in your 
profiles then DDMERGE uses the filename merdd. 

new : 
(optional) name of the file onto «which the new DD is to be 
written. If you dontt code the new parameters then DDMERGE 
uses the value of the profile variable ddnews and if 
there's no such variable defined in your profiles then 
DDMERGE uses the file name NEWDD. 

replace ; 


(optional) key causes entries contained in the old data 
dictionary whose names are duplicated by entries contained 
in the m data dictionary to be REPLACE'd by the m data 
dictionary. The filename DDLOG wit! contain a tist of 
duplicate entries and the action taken in each cases 


Example of DOMERGE Usage 
SES e-DOMERGEs OLD=MYOLDDDs M=MERGEDDs NEW2MYNEWDDs REPLACE 
* BEGINNING DD MERGE 
* END DD DDMERGE MYOLDD + MERGEDD ---=> MYNEWDD 
This exampie shows the use of DOMERGE to combine entries from the 
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data dictionaries MYOLDDD and MERGEDD to form anew data dictionary 
MYNEWDD.~ If an entry name is defined in both MYOLDDD and MERGEDD 
then the definition used in creating MYNEWDD is taken from MERGEDD. 
If the REPLACE parameter had been omitteds the definition from 
MYGLDDD would have been used» In either case an explanatory record 
is written to filename DDLQOG. 
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17.6 DDXREE_=_CROSS_ REFERENCE _A_DATA_DICTLONARY 


The DDXREF function produces a formatted cross reference listing 
of part or all of the otd data dictionary file. Parameters to 
DOXREF are 3:3 


old : 
(optional) name of the old data dictionary file from which 
you want across reference isting. If you don't code the 
Old parameters then DDXREF uses the value of the profile 
variable ddolds and if there*s no such variabie defined in 
your profites then DDXREF uses the filename OLDDD. 


(optional) name of the file to receive the output of DDXREF 
in a form suitable for printing on the ASCII printer. If 
you don't code the 1! parameters then DOXREF uses the value 
of the profile variabte ddtist. If therets no such 
variable defined in your profiles and you're running DOXREF 
LOCAL at your terminals, the output appears on a file catied 
LISTING. The § file is not rewound. 


type : 
(optional) key selects the type of entries you want to be 
inctuded in the cross reference tisting. Acceptable values 
for type are: flows compones elements files datas processs 
modules dfds scts notypes actions undefs and all. 


print : 

{optional) parameter to control the PRINTing of the outputs 
{ file. When the job runs in batch mode and there is no 1 
files one copy is printed automatically. If you run the 
procedure in tocalt modes no copies are printed uniess you 
specifically code some print parameter. For exampies you 
code printzc=3 to obtain three copies of the parameter 1 
file. The format of the print parameter is that of the 
parameters for the PRINT procedure. 


Exampie of DDOXREF Usage 


SESeDDXREFs I=MYOLDDDs L#LISTITs ALL 
* BEGINNING DD XREF 
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(Additional informative messages from DDXREF) 
* END DD DOXREF MYGLDOD ----> LISTIT 


This example shows the use of DDXREF to obtain a cross reference 
listing of all sections of the data dictionary MYOLDDD. The cross 
reference fisting will be on the focal file LISTIT. Printed copies 
could have been obtained by adding the PRINT parameter» 
PRINT=(C23sH=*XLIST®*). This wiitl print 3 copies with a header 
'IXLIST!®. 
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17.7 DOXCHK. =-_ CHECK A_DATA_DICTIONARY FOR_CONSISTENCY 


The DDXCHK function runs a cross check against a data 
dictionary. <A formatted listing is produced which contains the 
names of entries which meet criteria selected by the check 
parameter. Parameters to DDXCHK are : 


old : 
foptional) name of the old data dictionary file you want 
cross checked, If you don't code the old parameters then 
DDOXCHK uses the value of the profile variable ddotds and if 
there's no such variable defined in your profites then 
DDOXCHK uses the Filename OLDOD. 


(optional) name of the file to receive the output of DDXCHK 
in a form suitable for printing on the ASCII printer. If 
you don*t code the 1 parameters then DDXCHK uses the value 
of the profite variable ddlist. If therets no such 
vartabie defined in your profiles and you're running DOXCHK 
local at your terminals, the output appears on a file cailed 
LISTING. The # file is not rewound. 


check : 
(optional) key specifies the kind of consistency check you 
want run against the otd data dictionary. Acceptable 
values for check ares: undefs unrefs norefs recurs and 
full. 


print : 

(optional) parameter to control the PRINTing of the outputs 
' file. When the job runs in batch mode and there is no 1 
files one copy its printed automatically. If you run the 
DDXCHK procedure in tocal modes no copies are printed 
unless you specifically code some print parameter. For 
examples you code printzc2z2 to obtain two copies of the 
parameter ¢ file. The format of the print parameter is 
that of the parameters for the PRINT procedure. 


Exampie of DOXCHK Usage 
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SESeDDXCHKs I*MYOLDDDs LeLlLISTits FULL 
*. BEGINNING DD XCHECK 

( Additional informative messages from DDXCHK ) 
* END DD XCHECK MYOLDDD ----> LISTIT 


This example shows the use of DDXCHK to perform a full cross check 
of the data dictionary MYOLDDD. The cross check tisting witt be on 
the focal file LISTIT.’ Printed copies could have been obtained by 
adding a PRINT parameter. 
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Al.0 PROFILES 


A PROFILE is an importants, albeit optionals component of SES 
usages Any user may choose to estab!fish a PROFILE tn their catatog 
or procedure tibrary. PROFILE follows the same rules as any SES 
procedures that iss the name of the file must be PROFILEs and the 
First tine ot the profile must be the word PROFILE. From there ons 
the profile may contain just about any SES command. The most 
important aspect of the profile is the SEARCH directives explained 
in the next section. 


Typicaliys the types of things that aouser may place in the 
profile would be ;3 


o acommand to set a variable catted PASSWOR to the user'ts 
passwords. Procedures which optionally run as batch jobs can 
then get the user's password without having to be toid it on 
the SES control statement. 


0 commands to establish defaults for IJibrary names (for the 
source code and ftibrary maintenance procedures), tape numbers 
(and related information for the tape management procedure), 
and other data for various procedures. 


o SEARCH directives to establish a search order for procedures. 
It is possible for aeuser to have more than one PROFILEs and 
select which one to use by coding the PN or P parameter on the SES 
control statement. For examptes by coding ? 
sesspnzaitternate_profile.procedure_name list_of_ parameters 
a user can use the file "alternate_profile™ as the PROFILE for the 
duration of that porocedure call. Also» a user may use someone 
else's profile by coding the PUN or PU parameter. For examples by 
coding 3 
sesspunzprofile_owner.procedure_ name list_of parameters 


@ user can access the profite belonging to "“orofile -owner™. OF 
courses the PN and PUN parameters may be used together. 
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A1l.0.1 SEARCH DIRECTIVE - ESTABLISH LIBRARY SEARCH GRDER 


Using the SEARCH directives a user can establishs within PROFILEs 
the names of libraries to search when locating a procedures and also 
the user names in whose catalogs those procedure tibraries reside. 
The general form of SEARCH is 3 


\ SEARCH search specs search spececesees 
where “search spec" is in the form 32 
user name 
or 
(library names library _nameeesees user name) 
The first form indicates that the library name contained in the 
predefined variable SESLNAM is to be searched for in the catalog of 
the user specified by “user _name". The second form gives a tist of 


library namess with the tast item in the tist being the user name in 
whose catalog those tibraries may be found. 


Examples of SEARCH Directives 


\ SEARCH USER» SSS» SES 


\ SEARCH (CUSESLNAMs CCG)» USER» SSS» SES 


The first exampie shows a simpfe SEARCH directive. The search 
order for procedures is firsts the currently togged in user's 
catalogs then the SSS catatogs then the SES catalog. The second 
example searches first in the library given by SESLNAM in the CCG 
catalogs then in the currently togged in user's catalogs then in the 
SSS catalogs and finally in the SES catalog. 


Note : only one SEARCH directive is processed pec ES processor 
callie Second and subsequent SEARCH directives are ignored. 
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Ale1l LOCATING. A_ PROCEDURE 


The SES processor performs its search for a given procedure 
according to well defined and consistent rules. Basically SES has 
three methods of specifying how a procedure is to be ftocated. The 
SES processor has an internal table which contains the foltiowing 
data : 


' 
| 
t 
! 
' 
i 
' 
j 
' 
+ 
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: library name : user name ; 
H H ; 
; tibrary name : username ; 
H ; ; 
H etce. ; a 
; ; H 
; etce H ; 
E 2 a 
a 3 ¥ 
; etce : ; 
a a a 
a a 3 
+ + + 
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Given that the table may be set up by one of three different 
methods which are exptained in more detail in the sections 
followings the procedure that SES folitows to focate a procedure is 3: 


1. If there's a local file of the “procedure _name"» whose first. 
fine is “procedure_name™, that file is used as the procedure. 


2e SES searches the catalog of the user whose user name appears 
as the first entry in the tabtes for a file of name 
"procedure_name™,» whose first tine is "procedure _name", If 
such a file is founds it is used as the procedure. 


3e For each entry in the table» a search is made for a tibrary of 
name "Library name” in the catalog of the corresponding 
"user_name™s and searches that tibrary (which must have a 
directory) for a TEXT record of name "procedure name". If 
such a record is founds it is used as the procedure. 

4. If the search is unsuccessfuls an error message is issued 


-PROCEDURE procedure name NOT FOUND- 


The next three sections provide a more detatted explanation of 
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the methods by which the SES processor has its search table set ups 
The methods are basicaily the defauitts the user name specified on 
the SES control statements and the SEARCH directive. 


Al.1.1 DEFAULT ORDER OF SEARCH 


When the SES processor is catteds it sets up the following data 
in its search table : 


> pe a ee eo oe Ee RS ND AY Ee a ED ED aE 


This table is the normal default for SES. “user name" is the 
user name of the current user. 


"SESLNAM"™ is a predefined variable which contains the name of the 


SES Library NAMe.w "SESUNAM"™ is a predefined variable which contains 
the SES User NAMe. 


Alel.2 SEARCH SPECIFIED ON CONTROL STATEMENT 


When the user types the SES controt statements he may specify via 
the UN or U parameter of the SES programs which user's catalog to 
fook in for the procedure specified by the call. For example 3: 


sessun=user name,~procedure_ name tist_of_parameters 
specifies that the procedure "procedure name” is to be searched for 
anly in the catalog of the user “user_name” (if the procedure is not 
already tocal). In this case the SES processor modifies its search 
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table to contain only the following data ; 


$e wee eee $e eee ee eee + 
+ ESESLNAME 3} user name ; 
$e ee ee eee aah esheaieeiveeieseenenetetan + 


where "SESLNAM"™ contains the SES Library NAMe as befores and 
"user name" is the user name specified on the SES control 
statement. It is also possibile to tell the SES processors via the 
LIBPFN or LPFN parameters the name of the library to be searched for 
the procedures. For example 3 


sesstpfn=lib_name.procedure_name ltist_of_parameters 


specifies that the procedure “procedure name" js to be searched for 
agniy in the library "lib.-name". In this case the SES processor 
modifies its search table to reflect the following data : 


: fib.name i user name ;} 
+ > ap <ep ae ae Ge «ee a ee ee oe ee ee ewe: ae ER ey eR OE ce + 


where “user _name™ is the user name of the current users and 
"lib _name™ is the tibrary name specified on the SES contro! 
statement. Of courses the UN and LIBPFN parameters may be used 
together. 


A1.1.3 SEARCH ORDER SPECIFIED VIA SEARCH DIRECTIVES 


The third method of specifying the order in which to took for the 
procedure is via SEARCH directives in the user*s PROFILE. For 
examples supposing that the user's PROFILE contains the following 
SEARCH directive 3: 


\ SEARCH CHOLMLIBsJIMLIBsHG74)5 AM74s JFO3s (CANDYLIBSED73) 
in this case the SES processor would modify its search table to took 


like this : 
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$a een ee eh ee an + 
i HOLMLIB + HG74 ; 
CJ 4 a 
| ] a 
; JIMLIB. : HG74 ; 
a a a 
sy & ] 
: ESESLNAME ¢ AM74 3 
§ a 8 
a 4 a 
+ G&SESLNAME | JFO3 ; 
; ANDYLIB : ED73 ;¢ 
+ + + 


ND ON ene ENE Se AAR elie alts ANS 1 eae ms en ann ce 4 


Note : SEARCH directives are ignored if the UN or LIBPFN 
parameters were specified on the SES control statement. 
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B1.0 OPERATING MODES OF THE SES PROCESSOR 


The SES processor processes procedures 


RUN This is the normal mode. The. 


in one of three modes 3: 


procedure is processed» 


presumably generating contro! statements» and then these 


contro! statements are executed. 


TEST In this mode the procedure is processed in the normal manners 
but the generated contro! statements are not executed, 
instead they are piaced on a designated file for possibie 


inspection by the usefre This 
debugging new procedures. 


mode is meant as an aid in 


HELP This mode is similar to test modes however instead of 


generating control statementss a 
mode produces some documentation on 


The modes are selectable by the user by 
the SES processor; and the procedure can 
modes it was called by means of predefined 
SES program. These variables are : 


MODE This variabte may be compared 


procedure set up for HELP 
its purpose and usages 


means of parameters to 


determine in which of the 
variables set up by the 


with the variabies RUN» 


TEST» or HELP to determine which of the modes its iin 


effect; for example 3: 


\ IF MODE = HELP THEN 

" code for HELP mode * 
\ QRIF MODE = TEST THEN 

" code for TEST mode * 
\ ELSE 

*" code for RUN mode * 
\ IFEND 


PRIMOUT This variabfe contains the name of the PRIMary OUTput 
file. In RUN mode this is the new contro! statement file; 
in TEST mode this is the file designated by the test mode 
parameter on the SES call (default is SESTEST); and in 
HELP mode this is the file designated by the help mode 
parameter on the SES calf (default is OUTPUT). PRIMOUT is 


particularly useful in HELP 


mode for directing the 


descriptive information about the procedure to the “fite 


selected by the user on the 


SES call. This may be 
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accomplished as follows : 


\ IF MODE = HELP THEN 
\ ROUT FA=PRIMOUT 
" descriptive information about called procedure ™ 
\ ROUTEND PRIMOUT 
\ STOP 
\ IFEND 


Note : in HELP modes a PARMEND directive is interpreted as a 
STOP directives to prevent a procedure not set up for HELP mode from 
doing strange or undesirable things. 


B1l.l SELECTING MODE_OF_QPER ATION 
As stated aboves the mode of operation for a procedure iis 
selected by a parameter to the SES processor. 


TEST mode may be selected by one of the keywords 2: TESTs TMs or 
Te For example : 


sesstest.procedure_name list lof_parameters 


processes procedure "procedure_name™ in TEST modes and ptace the 
generated control statements on fite SESTEST; whereas ; 


sesstz=my_file.procedure_name fist_of_ parameters 

processes procedure "procedure_name™ in TEST modes but piaces the 
generated control statements on file "my_file"™. 

HELP mode may be setected by one of the keywords : HELPs HMs or 
He. For exampte ; 

sessheip.procedure_name 

causes procedure "procedure name” to be processed in HELP modes and 
any descriptive information available is placed on File QUTPUT; 
whereas 3 


sesshzmy_info.eprocedure_name 


causes procedure “procedure _name™ to be processed in HELP modes but 
any descriptive information available is placed on file “my_info". 
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Note : that when calling a procedure in HELP modes ai tftist  ~0of 
parameters should not be given. HELP for a group of procedures may 
be obtained by one cali to SES» as follows 3° 


sesshelp.proc_il3 proc.23 proc_3 
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C1-0 ERRGR_AND_INEQRMATIVE MESSAGES 


This appendix describes the messages produced by the SES 
processor when errors are detected and under certain other 
circumstances... 


Clel SYNTAX_ERRORS 


Syntax errors are detected when processing the SES cat! statement 
and directives within procedures. Before the individual messages 
are describeds it should be noted that if a procedure is called from 
the terminal and a syntax error is detected on a tine within the 
called procedure (or the procedure is calted in TEST or HELP mode 
and a syntax error is detected on the call line) the following tines 
are written to the terminal : 


“ERROR DETECTED IN FOLLOWING LINE BY SES- 
the tine which was tn error 
* 


and the * indicates the point in the line at which the error was 
detected fin generals the error actually occurred prior to where the 
* points). These tines are foliowed by the error message itself. 


NOTE 


Syntax error messages thats at first glances don*t appear to 
make much sens@s may result from the omission of exptiscit 
punctuation (e@ege commass equal signss parenthesess etce). If 
you get a message of this types try re-entering the command with 
ali such punctuation; either the error will disappear 
altogethers or you should then be able to figure out what'*s 
wronge 


oe Se cb Be 66 ae 2b oe HH EE He 
oe es 4h Oe 46 86 On 4 20 Oe Ot 
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The individual syntax error messages are described below. 


“REQUIRED PARAMETER NOT GIVEN- 


Meaning 3 a parameter required by the procedure or \ directive was 
not supplied on the call. 


“TOO FEW VALUES GIVEN FOR PARAMETER- 


oe 


the minimum number of values for a parameter were not 
given, 


Meaning 


“LINE OR STRING TOG LONG- 


Meaning 3? a tine longer than 80 characters was read (from the 
procedure)» or substitution caused a line to exceed 80 
characterss or when concatenating (++ operator) two 
strings the resulting string would exceed 80 characters. 


~TOO MANY VARTABLES- 


oe 


the calied oprocedure (and the user's profile) have tried 
to define too many variables (maximum is 200). 


Meaning 


-TOO MANY PARAMETERS GIVEN- 


oe 


a procedure or \ directive was catled with more 
parameters than it knows what to do with. 


Meaning 


-TGG MANY VALUES GIVEN FOR PARAMETER=- 


ee 


more values were supplied for a parameter than its 
defined maximum. 


Meaning 
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C1.0 ERROR AND INFORMATIVE MESSAGES 
C1.1 SYNTAX ERRORS 


Meaning 


Meaning 


Meaning 


Meaning 


Meaning 


Meaning 


Meaning 


oe 


as 


oi) 


oe 


-UNKNOWN KEYWORD- 


a keyword for a parameter (or some built in functions) 
was mis-speited or otherwise incorrectly specified. 


“UNDEFINED COMMAND OR VARIABLE- 


self-explanatory. 


-~DOUBLY DEFINED OR INVALID PARAMETER- 


setf-expianator ys 


-VALUE OUT OF RANGE- 


the value given for a parameter tor function argument) is 
not within its allowed range. 


~VALUE RANGE NOT ALLOWED FOR PARAMETER- 


a value for a parameter which is not allowed to have 
value rangess ise. vatues of the form xeeys was coded in 
such a format. 


~EXPECTING NAME- 


seilf-explanatorye 


“EXPECTING STRING— 


se! f-explanatory. 


“EXPECTING NUMBER=- 
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Meaning 


Meaning 


Meaning 


Meaning 


Meaning 


Meaning 


Meaning 


Meaning 


a 
» 


ee 


oo 


oe 


ee 


oe 


self-explanatory. 


~EXPECTING OQPERAND=- 


a names strings or number was expected. 


“EXPECTING OPEN PARENTHESIS- 


seif-explanator y. 


“EXPECTING CLOSE PARENTHESIS- 


self-explanatory. 


~EXPECTING COMMA- 


seif-exolanatory. 


-EXPECTING EQUAL SIGN- 


setf-explanatory. 


~EXPECTING END OF LINE OR STRING- 


setf-explanatory. 


“INVALID NAME- 


aname given was tonger than 7 characterss did not start 
with a letters or contained characters other than tetters 
and digits. This message is also issued if the specified 
name is iftlegal in the context in which it was used. 
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“INVALID STRING= 


Meaning 3: a string constant was not properly terminateds i.e. the 
closing single quote was missing. 


~INVALID NUMBER- 


Meaning : anumeric constant was not specified according to the 
syntax defined in section 01.3 or contained “digits” 
greater than or equal to its base. 

~INVALIO COMMENT- 

Meaning ?:. a comment was not properly terminateds i.e. the closing 

double quote was missing. 
-~INVALID CHARACTER- 
Meaning : a character not in the character set table in section 


D1.2 was encountered outside of a string constant or 
comment. 


C1.2 PROCEQURE_ORGANIZATION_ERRORS 


These messages inform the user of problems with the “structure® 
of a procedure. The messages are generally self-explanatory. The 
symbol SEG should be read as "procedure segment™ (i.e. a "thing" 
which is INCLUDEd by a procedure). 


“EXPECTING IFEND~ 
“EXPECTING WHILEND—- 
—~EXPECTING END-SEG-— 

~UNEXPECTED ORIF- 
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“UNEXPECTED ELSE- 
“UNEXPECTED IFEND- 
“UNEXPECTED WHILEND- 
~UNEXPECTED END-SEG- 
-~UNEXPECTED CYCLE- 

“ILLEGAL USE OF WHILE/WHILEND OR CYCLE- 


C1-3 ELLE.USAGE ERROR _ MESSAGES 


The message 3: 
-FILE/RECORD filenam NOT FOUND- 


is issued when the INCLUDE processor cannot tocate the requested 
"procedure segment". 


The message 3 
~FILE fitenam ALREADY IN USE- 


is issued by etther the INCLUDE or ROUT processor when the 
designated file is already being used by the SES processor. 


The message ;: 
-PROCEDURE procnam NOT FOUND- 


is issued when the requested procedure could not be found. 


C1i.4 INTERNAL ERROR MESSAGES 


If any of the folling messages are ever encountereds the authors 
should be informed. 


“INSUFFICIENT FIELD LENGTH FOR SES- 
“INSUFFICIENT FIELD LENGTH TO CONTINUE- 
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C124 INTERNAL ERROR MESSAGES 


-SES- INTERNAL TABLE OVERFLOW ~TOKTAB- 
-~TOKEN ALLOCATION ERROR= 
~TOKEN STACK OVERFLOW- 
“1/0 STACK OVERFLOW- 
“CIO DIRECTIVE ERROR- 
-PFM DIRECTIVE ERROR= 


In additions the following message may be issued foltftowing any of 
the above error messages or syntax error messages : 


“INTERNAL ERROR IN SES=- 


C1i-5 LNEQRMATIVE MESSAGES AND PROMPTS 


When entering continuation lines For an SES procedure cali from 
the terminals the SES processor issues the following prompts which 
should be interpreted as "ENTER CONTINUATION LINE®*: 


20? 


When the SES processor has compieted processing a procedure in 
TEST modes the following message is issued 3: 


-TEST OF procnam GN FILE filenan—- 


When the SES processor has completed processing a procedure in 
HELP modes the following nessage is issued : 


-HELP FOR procnam ON FILE filenam- 


When the SES processor is searching for procedures or INCLUDing a 
procedure segments it may encounter errors with a file. In such a 
cases one or more of the foliowing messages may be issued to the 
dayfile. The SES processor won't abort because of one of these 
errors since the procedure or procedure segment being searched for 
may not be in the file on which the error was detected. 
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“WAITING FOR PFN=filenam UNsusernam- 
“ERROR WITH FILE PFN=filenam UN=usernam- 

~NO DIRECTORY PFN=filenam UN=usernam—- 

-BAD DIRECTORY PEN*filenam UN=usernam— 
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D1.O SEMISEQRMAL_ SYNTAX DESCRIPTION 


".,eeWhat is the use of repeating all that 
stuff">» the Mock Turtie interrupteds "if you 
don't exptain it as you go on? It*s by far the 
most confusing thing I ever heard!" 

Lewis Carroll 


This section gives a semi-format description of the syntax used 
when writing procedures for and calling the SES. The description is 
not intended to be rigorous. First we introduce the "meta-language”™ 
used to describe the syntax; second the character set used by SES is 
defined; and finally the syntax description itself is given. 


D1l.l THE MELA LANGUAGE 


This section describes the symbols used in the description of the 
SES syntax. 


Symbol Interceretation 

332 This symbol should be read as "is defined to be", 

; This symbol is used to indicate alternativess for 
example 3 Ai B means that either <A or 8B is 
allowed. 

<item> This group of symbols denotes that item is to be 
treated as a syntactic unit in relation to 


surrounding meta symbols. 


Litem] This group of symbols denotes that item is optionals 
ie@s. 2zeFfo or one occurences of item are allowed. 


{item} This group of symbols denotes that item may be used 
zero or more times. 


Spaces are used in the syntax description to improve its 
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readabilitys however they are not part of what's being defined 
untess otherwise noted. 


There are a few instances where some of the meta symbols 
themselves are part of the syntax definitions and when this occurs 
the meta symbol is underlineds for example 3 i means the 3 
character and not the meta symbole When an _ appears atones it 


means itself. 
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D1le2 CHARACTER_SET 


Characters used for NAMES 


A er Z a 
O ee 9 


ae 2 


ae2eeesennen ana e97939930838390028 


o23893938039038 


Characters 


O +s 9 


e223070993030230293202330908082983 


A os F a we fF aan 02390908 
{ 99932080032 0229008209320992309229298 
) evans oaaneeaeseavv, ees en aseaen2 


Characters used for OPERATORS 


aes gua 0828320030853 9202083838020007039 2 
sees asnevaseasanseasea 2080838329332 
eases eannnnnnn anna de292808908099 8 
agave seaneananananeanneennne0208932088308828 
0000988988888 8808888888888 8 


eeoaneaeoavanenseaeseaneae2820003929030 


Avut «= € 1 + 


ess0083808900903802083033380897309030 


Characters used for PUNCTUATION 


eseenasenvneannevneananeaeendane2022322023 % 
es evevenannneansesveannev7988029389 80 
eaenn0nn02000802923080800932980826082099300702 9 


gae2n009200900808970800838082893889292930933890982 


¢ = wm, 


aeneaeeeveasanvnavneaneaneanenseaea929020898 


Letters 
Decimal Digits 


used for INTEGER CONSTANTS 


Decimal Digits 
Hexadecimal Digits 
Qeen Parenthesis 
Close Parenthesis 


Pius Sign 

Minus Sign 
Asterisk 

Slash (Stant) 
Eauai Sign 
Greater Than Sign 
Less Than Sign 


Blank (Space) 
Comma 

Dpen Parenthesis 
Close Parenthesis 
Period 


Character used for STRING DELIMITER 


’ eaensse vane 8000200002938399203089098 


Apostrophe (Singte Quote) 


Character used for COMMMENT DELIMITER 


bie 2020200909 9390928320909939838803808303097933 9 


{Doubte) Quote 
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D1.2 CHARACTER SET 


(Default) Character used for SUBSTITUTION DELIMITER 


£ 990908098090 009 900990008998 Ampersand 


(Default) Character used for DIRECTIVE HEADER 


\ aaeecrceenecnarsesvsessaeeees Reverse Siash (Slant) 
Note =: Any ASCII character not tisted tn the above character set 
has no meaning to the SES processor. These characters may 


however be used in stringss commentss oor as data 
characterse 
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D1.3 SYNTAX 


D1.3e1 BASIC DEFINITIONS 


upper case letter> 3:32 AiBic io0: E32 F iG:idH 
+ 7.3 3 § K $ bb. MS NY Ot RP 
-;923RiS $ Ti uiviw dé? xX 
e-¥°o Z 

<lower case fetter> 3:2 atibiciditet fi gqiith 
; § i jt ke F Yt mintoitp 
+ q@iris } $ us vi wf rx 
$y i 2 

<letter> 2:= <upper case ftetter>d 

+ <lower case Jetter> 

<decimal digit> ::= 0411312: 33:44 41°55 «3 *6 3 «73 «86 $ 9 

Chexadecimal digit> ::= A ?8ic¢t $b it E : F 
+ as btcidi ei f 


<digit> s:2= <decimal digit> 
$ <hexadecimal digit> 


5 3 6 


<Cbase> 322 2 ¢ 3 ? 
rH 13 3: 14 


01.232 TOKENS 


This section defines the building bilocks of SES syntax» 
collectively preferred to as tokens. The internal token scanner of 
the SES processor is made availbie to the procedure writer by means 
of the bullt-in function TOKEN. 


<token> 232 <name> + Cnumber> ¢ <string> 
$$ <detimiter> { <operator> 
<name> 22:2 <letter> (<tetter> $ <decimal digit>} 
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D1.0 SEMI-FORMAL SYNTAX DESCRIPTION 
D1.23e2 TOKENS 


<upper case name> 33:2 
upper case tetter> ({<upper case letter> {| <decimal digit>} 


All names are lSimited to seven characters in length. With the 
exception of <upper case nameds» any name may be specified with 
either upper or tower case fetterss but before a name is used ati 
fetters in it are converted to upper case. For instance the names 
ABCs abcs aBes and so ons are all equivalent. (This includes any of 
the “™“speciai™ namess such as O00» THENs WHENs etc. In this 
descriptions howevers these names are atways spelled out in upper 
case tetters.) 

€variablte named 3:3= <name>d 

€function name> 232= <name> 

<parameter name> 22:2 <name> 

<directive name> 22= <name> 

<assigqnee> 3:= <parameter name> + <variable name> 
€procedure name> :3:= Cnamed 


Cprocedure identifier> 2:= <upper case name> 
€number> 232= <decimal digit>d {<digit>} (€(<base>)] 


€string character> ::= ?! 
$ <any ASCII character except '> 


<string> 2232 '{<string character>d}! 


Cconstant> 2:32 <string> +: <number> $ <name> 


<delimiter> 2: $$ € 4 ) & = f «© & eefe} 


= » 
’ end of tined 


<operator> %23= <graphic operator> } <mnemonic operator>d 
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<graphic operator> 2:32 ** | *€ § / 5 J § + 3 — | HF 
; = § /* $$ € 3 €= $ Di 2 


<mnemonic operator> 3:22 AND } OR } XOR : NOT 
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D1.363 USE OF SPACES 


Before discussing when and how spaces can be used we will first 
define the syntax of comments. 


<comment> 33:= "{<any ASCII character except ™>}" 


In almost all cases a comment is treated identically to a single 
biank characters and 2 or more contiguous blank characters (Cor 
comments) are treated as a single blank character. Blank characters 
and comments treated in this manner are known as spacess 


Spaces may be used between tokens to improve readability and in 
general may be used to replace commas when used as arguments values 
or parameter separators. Spaces must be used to separate tokens 
when no <delimiter> or <graphic operator> can be used to separate 
them. For example the spaces between the tokens on the following 
fine must be present :. 


Vl AND V2 
whereas the following two expressions are equivalent : 


Vl + V2 
V1l+V2 


Furthers the following value tist contains 2 vatues : 
( Xs -3 ) 
whereas the next contains only 1 vatue : 
( xX <3 ) 
namely the vaiue of the expression X=-3. 


Spaces within character strings represent themselvess and 
comments may not be used in front of the \ which occurs at the 
beginning of directive tines» nor following the continuation signal 
at the end of directive or call lines. Lines within procedures 
which are not directives or continuations of directives or lines 
which are read using the ACCEPT directives are treated as unquoted 
strings» and therefore spaces are significant in them. Whenever a 
line is read by the SES processors traiting biank characters are 
deleted. <Alsos it is legal to precede the \ of a directive tine by 
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D1.3.3 USE OF SPACES 


one or more blank characters. 
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D1le3e4 EXPRESSIONS 
<expr> 332 <lterm> {(<or> <itterm>} 
Zor> 3:2 OR 4! XOR 
<iterm> 22= <tifactor> CAND <ifactor>} 
€ifactor> i2:= (NOT) <ftorimary> 


<iprimary> 222 <sterm> {<Crel op> <stern>} 
<reloop> 23= = | /= $ € 3 = 3} 2t 2= 


<sterm> :3= <term> {++ <term>} 


<term> 33:= E[<term op>] <factor> {<term op> <factor>} 
<term op> :3= + } =- 


<factor> :2= <primary> {<factor op> <orimary>} 
<factor oop> t22 * § ¢ 2 47 


<primary> 32= <onerand> €** <operand>} 


“ 


<variable reference>d 
<function reference>d 
{ <exprd ) 
<constant> 

<null> 


€operand> 33: 


we en “eh oe 


€nuli> t22 
<variabie reference> ::2 Cvariabie name> 
€function reference> ::2= <function named <arguments> 


<arguments> %:= { E€C<arg> {» <arg>}] ) 
; <null>d 
Carg> %23= <name> : <Cexprd 


must resotve to an integer 
must resolve to a string 
must resolve to an integer 
f the value is zeros it 
is taken to be FALSE 
if non-zeros it's taken 
to be TRUE 


<integer exprd> 332 <exord 
€string expr> 23= Cexor> 
€boolean exprd> 3:3= <experd> 


$323 3 3 & 
ibe 
<y 
2322323 3 83 
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D1.325 FOREIGN TEXT 


Foreign text is primarily used for parameter vatues which are to 
be in turn used as parameter fists (e.g. to secondary procedures) 
or Simply to prevent the SES processor from evaluating an 
expression. 


The scanning of foreign text is totatliy different from scanning 
"normal" text. The characteristics of this special scanning are 


= parentheses are "balanced" 

~ single and double quotes are “matched” 

- if not contained within parentheses» singie aquotess or 
double quotess the tokens 3 commas periods ellipsis 
{ee2f-})s and close parenthesis terminates the scanning 
{and thus the foreign text vaiue). In additions spaces 


which are used to separate names» numberss or strings from 
names numbers or strings terminate scanning; as does an 
"unencliosed"™ open parenthesis which follows a string or 
number (Notes that an open parenthesis following a name 
does not terminate scanning - this is because function 
references are allowed in foreign text but the foreign 
text scanner doesn't evatuate what it scans» and thus does 
not know if the name is indeed the name of a function). 


Foreign text may also be described as having the general format 
of an expressions but the expression is not evaluated when scanned 
as foreign text. During scanning comments and bianks not contained 
within single quotes are “thrown away” and single biank characters 
are inserted between tokens which would otherwise not be separated. 


The following example itfustrates some of the idiosyncracies of 
foreign text 3: 


\ vtist = "(a bc (de) *#p qt#tttr, s#t 12308) (xely+3)) 2° 
\ count = VCNT (viist) wa 
\ vatue = VALS (viists 3) . 3-7 
\ stist = GENLIST (vtists index) "4" 


The first tine defines a value list in the variable vtist. Line 
2 sets the variable count to the vatue 6. Line 3 sets the the 
variable value to the value : 
Cid E) 


and tine 4 sets the variable sfist toe the value 3: 
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AsBsC{(D Els'p qt*r,s $44123(8) (Xo ¥43)) 


The next example illustrates how a parameter tist may be passed 
as a foreign text parameter ;3 


\ plist = *( jizinfile "columns" cols*1..80 ozout )? 
\ count = VCNT (plist? 

\ tow = VALS (plists 2s LOV) 

\ high = VALS (plists 2s HIV) 

\ stist = GENLIST (ptists index) 


Count is set to 33 tow is set to : 
COLS=1 
high is set to 80; and stist is set to 3 


Is INFILEsCOLS=1..80s 020UT 
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D1.3.6 PARAMETER LISTS 


<parameter fist> 2:= [—<parameter> {{€2] <parameter>}1. 


= {<parameter name> [21] <value Jist> 
; <parameter name> 
: <nul dd 


<€parameter>d 33 


<value fist> *:2 <vatue>d 
; ( C<vatue> {f5] <vatue>}] ) 


<value> :3:= <value side> Ceefe} <vatue side>d] 


<value side> i23= <exprd i <foreign text> 
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D1l.327 SES PROCESSOR CALL 


} <end of lined 
1 <end of tine> 


2 


<esepy> 33 | 
2 


<proc cali 33% <€procedure name> Cs] <parameter tist> <csep> 
control statement> %s3:= <string> 


<control statements> ::= <control statementd> U<csep>] 
{€s1 (€<controt statement>] (C<csep>]} 


<cali element> 33:2 <Cproc call> §$ <control statements>d 


<SES cald> 22= SES Cs» <parameter tist>) . 
<calil etlement> {<calil element>} 


Because of operating system restrictions» a <parameter tist> 
following the SES (processor name) must have expticit punctuation. 
That is to says commas must be used to separate parameters (and 
values) and equal signs must be used to separate parameter names 
(keywords) from their value tists. 


Alsos the operating system is not weil acquainted with flower case 
Jetterss so onty upper case should be used} howevery NAM/IAF (Cor 
TELEX) and the SES processor alleviates this probtem by converting 
lower case tetters to upper case on command and continuation tines. 


When <control statements> are used in a <SES cati>ds the SES 
processor insures that they are ali "property" terminated» ie. 
each <contro!l statement> string is scanned for a right parenthesis 
or period and if neither of these characters is founds a period is 
appended at the end of the string; if however, a right parenthesis 
or period is founds the string is left alone. NOTE that this is the 
onity validity checking of the <contro! statement> done by the SES 
processore 
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01.3.8 SUBSTITUTION 


€substitute> %::= <parameter name>d> :} <variable name> 
<default substitution character> 232 & 


Calternate substitution character> 3 
BLAS SESS SESE OO RE SO 20 te 2 ie tee ie 
SNP Sear Li gi Lisi: 

<substitution chard i:= 


<default substitution character>D 
: Calternate substitution character> 


3= 
Nt. d Bates 
% tptetesesae 


€substitution> 3:= 
<substitution char> <substitute> <substitution char> 
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D1.329 PROCEDURES 


<procedure> *3= <procedure identifier> {<procedure line>} 
Cprocedure Jine>d 23:= {<procedure fine element>} 


<procedure tine element> 3232 Csubstitution>d 
$ <any ASCII character> 


The process of substitution applied to a <procedure tined yieids 
an <object tine>d. 


<object tine> %3= <directive line> 
; <empty tine> 
; <data line> 


” 


C<default directive character> t3= 


alternate directive character> 
ee 2 Se See Oi Pe ee oe eee a 


PEL_ISIDILiDILihiz 


<directive header> 3:= 
<defauit directive character> 
+ Calternate substitution character> 


ad 
a @ 

Wen: 
& 


<directive ftinedD *:= <directive header>d <directive>d 
<empty lined 2:2 
€data line> 33:2 any fine which is not “empty"™ and does 


not begin with a directive header> 


Note : <empty tlineds may contain comments enclosed in doubfe 
quotes. 
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D123.10 DIRECTIVES 


<directive> %:= <assignment> 
; <if white> <boolean expr> [<then dod] 
i; <exit cycle> [WHEN <boolean expr>d] 
} <directive name> <parameter fist» 
<assignment> 32: <assignee> = <expr> 
<if while> ‘2:2 IF $ GRIF % WHILE 


<then do> i3:= 
: bo 


exit cycte> 23= EXIT 3: CYCLE 
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D1e% LINES AND_THEIR CONTINUATION 


Although the preceding syntax descriptions implied a totally free 
form of "language™s the SES processor actually deais with its input 
a fine at atime. Ends of tines are terminators for ail syntactic 
units (tokens) except as described below. 


It is sometimes necessary to pass more parameters to a procedure 
(or give more paraneters to a directive) than will fit on one line 
(fines are normally ftimited to 80 characters in tfengths howevers 
TELEX further timits the command fines to about 70 characters -- for 
reasons known only to TELEX -- continuation lines entered at the 
terminal mays howevers be 80 characters tong). To handie this 
problems SES processes continuation fines. 


The effective net resuit of using continuation tines is to 
construct an unbroken (and conceivablys very tong) tine. 

Continuation may onty be used in conjunction with SES directives 
and when calling SES to process ao procedure. Continuation iis 
signatied on the tine which is to be continueds not the continuation 
fine itself. Note that the <continuation signal> is not considered 


to be part of the fine. The mechanism for doing this is defined as 
follows 3 


<whote lined %i3= 
Cline starter> <Cstuf 1> £ <continuation signal>d 
<stuf 2> € <continuation signali> 


<stuf n> } J 


continuation signal> 222 wel} 


<jine starter> ::= <directive header> <name> 
: SES <parameter fist> 


Cstuf i> 23= <whatever belongs with the fine starter> 
"1 <2 i ¢<=n*” 
The effect of this is as if <whole tine>d> had been specified as * 
<line starter> <stuf 1> {<stuf 1>} 
Note : Syntactic units (tokens) may not cross tine boundaries. 
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El-0 ACQUIRE UTILITY 


ACQUIRE is a program that enables easy retrieval (acquisition) of 
permanent files. 


ACQUIRE combines the functions of the NOS "ATTACH® and "GET* 
control statements. For each file specified ACQUIRE determines if 
the file is atready tocai to the job (untess suppressed by the PD 
parameters, see beiow)s if so it is rewound; if nots then for each 
one of a ftist of user namess an ATTACH Is attempted (waitings if 
necessarys until the file is not busy)» and if that fails a GET Is 
tried. Ifs after all thiss the file is stiti not locats an 
appropriate dayfile message is issued. 


Untess the A (abort) parameter is specifieds ACQUIRE aborts only 
because of control statement format or argument errors,s or because 
of a permanent file manager (PFM) detected error; and not because 
one (or more) of the specified files could not be found. 


The control statenent format for ACQUIRE is : 
ACQUIRECEfnlLzpfnalstfn2=pfn2s<2e2/0plsop2se.ce) 
1fni is the (focal) name of the file once it has been ACQUIREG 
{note that this is the name used in making the "is the file 


already tocal?™ test) 


efni is the permanent file name for the file Cif =pfni is omitteds 
pfni is assumed to be the same as tfni) 


opi specify options used for acquiring the file(s) :3 
A specifies that if a file is not founds ACQUIRE 
should abort 
NA is the opposite of A {and is the default) 
PO specifies Permanent Onty»s iee- that if a file is 


already locats it is returned and then the ATTACH 
and GET are attempted 


UNezusers specifies a iist of user names to be searched for 
each file (the user names are separated from each 
other by commas) 
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M=mode specifies the access mode desired for the file 
(READ or R -- the defaults WRITE or Ws or EXECUTE 
or E). If the file is locals the mode will not be 
changed, To insure the mode will be changed» the 
PO parameter should atso be specified. 
PW=pw specifies the permanent file's password 
PNepn specifies the packname for the permanent file 
When ACQUIRE is attempting an ATTACH or GETs if the file is busy 
or if a permanent file utility is actives the following message is 
issued and the request is retried : 
—- WAITING FOR PFNzpermanent_file_name UNzuser name 


When ACQUIRE is attempting an ATTACH or GET» if an error is 
detected by PFM the following message is issued and ACQUIRE aborts : 


- ERROR WITH PFN=permanent_file_name UN=user_name 


In both of the above cases» the designated message is preceded by 
amore specific message generated by PFM. 
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Fie0 EDT =_ENHANCED VERSTON_OE_NOS_ TEXT _EOQITOR 


EDT is an enhanced version of the standard NOS text editor 
(EDIT). EDT incorporates column searchess modified FIND and FINDS 
commandss Input and Output file and TAB specification on the EDT 
calis control over terminal interrupts» INPUT MODE optionss multiple 
entries on command tiness command buffers» permanent fiie functionss 
and miscelianeous other additions. 


User documentation can be found on TOOLDOC (SESD009). 


Fl.l EDT CONTROL STATEMENT FORMAT 


EDTslifnlislifa2),Cifn3sisCtabj}.C{cmdstr] 


tfnl - name of the file to be edited 


ifn2 - name of the file containing the editor commands 
(default = INPUT) 
- if Os» an END command is executed after processing the 
commands in cmdstr 
- if l»s commands are read from fite INPUT after 
processing the commands in cmdstr 
ifn3 - name of the output File (default = OUTPUT) 


tab - tabset to be used by EDT 


cmadstr ~ editor Command String to be executed if ifn2 = 0 or 1 
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G1.0 EXTRACT UTILITY 


EXTRACT is 2 program that enables easy retrieval of records from 
permanent file (Cor tocat) libraries. 


Although EXTRACT is designed primarily for use in procedure 
filess it is also very useful on its own. , 


EXTRACT is similar in function to the NOS "GTR" statement. It 
differs from "GTR® in the following ways: 


o EXTRACT insists that the library to be searched has a 
directory (a directory can be built using the NOS utility 
"LIBEDIT™). 


o The record type parameter for EXTRACTs if givens applies to 


all records to be extracteds and if not givens only the names 
of the records are used when searching the tibrary. 


Oo Each extracted record is copied to its own tocal file by 
EXTRACTs rather than all to the same file. 


o EXTRACT does not insist that the library to be searched be 


focal to the job when it’s calleds but ACQUIRE*s the tibrary 
from a permanent file catalog. 


The control statement format is: 


EXTRACTCUILFnlernls lFn22zrn2s0ecc/O0PlsOPZsee0) 
ifni Is the focal file name given to the record once it’s 
_ extracted (Ifni is REWOQUND before and after the extraction 
takes piace). 


rni Is the name of the record to be extracted (if omitteds it is 
assumed to be the same as Ifni). 


opi These parameters specify options that contro! the extraction 
process 3 


A Specifies that if a record is not founds EXTRACT 
should abort. 
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NA Is the opposite of A (and is the default). 


Tert Specifies the record type (if givens it applies 
to ail records being extracted; if omitteds only 
the record names are used when searching the 
library). 


L=tibname Specifies the name of the library to be searched 
for the records (if omitteds, “PROCLIB" is 
assumed). 


LFEN=libifn Specifies the focal file name for the library 
(if omitteds the "ltibname”™ from the L paraeter 
is used). Note that this is the name used to 
make the "is file jfocat?" test when ACQUIRing 
the library. 


UN=un Specifies the user name of the permanent file 
catatog to be searched for “fibname” if it's not 
already focal (Cif omitteds the current user is 
assumed). 


PWzoW Specifies the tibrary'ts permanent file 
password. 


PN=pn Specifies the fibraryts permanent file 
packname. 


Valid record type designators are documented under the 
description of the "CATALOG" control statement in the NOS Reference 
Manual. 


In addition to these standard types» there's one more “type” 
processed by EXTRACTs which is designated by "TXT". This "type" is 
used to denote “TEXT” records thats when extracteds are to have 
their first tine (which contains the record's name) “stripped off". 
This is useful ifs for examples one has records containing 
directives for a NOS utiflitys in which case the name of such a 
record is in afl likelihood an iittegai directive to the utility 
program. 


EXTRACT aborts under any of the following conditions: 
0 fornat or argument error(s) on the control statement 


o the specified tibrary coutd not be AQUIREd 
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o the library file does not have a directory as the last record 
before end-of-information 


Notes howevers that EXTRACT doesntt abort if it does not find any 
of the requested records (only an informative dayfile message is 
issued)» untess the Abort parameter is coded on the call. 


If the tlibrary file is not tocal to the job when EXTRACT is 
calleds it is RETURNed when EXTRACT terminates normally; buts if the 
library file is tocats EXTRACT REWIND's it prior to normal 
termination. 
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H1.0 SESMSG_UTILITY 


SESMSG is a program which copies the comment fietd of its call 
fine to a file. The controi statement format is: 


SESMSGsfile.message 


file is the name of the fite to receive the message (if 
omitteds OUTPUT is assumed) 


message is the message to be written to the File 

The message is written to the file onty if the File is a terminal 
files or if "File™ is explicitty quoted on the call tine. 

SESMSG is used in procedure files to inform the user about what 
the procedure is currentiy doing. It is afiso used for creating 


files of input directives to utility programs when such directives 
are dependent on execution time considerations. 
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I1.0 JOBID - PRODUCE LARGE PRINT BANNER 


T1.0 JOB1D.=_PRODUCE LARGE PRINT BANNER 


JOBID is the program used by the SES PRINTID procedure to produce 
“large orint™ banner pagese 


The output produced is one or more pages of 5 tines of block 
characters at 10 characters per tine. Alt empty character positions 
and tines are blank filled. Additional pages of biock tettering is 
produced if any information is specified following a fifth delimiter 
characters, and so on. 


The input to JOBID is a string of characters in the following 
form 3 


finel/line2/tine3/line4/lined 
or 
Vitis elinelttine2t+lines+tines+tined 


In the first form the stant (/) character is taken to be the 
delimiter between tines (i.e. it is the default detimiter). The 
second form must be used when you want one or more of the fines to 
contain the stant character. In the example aboves the delimiter 
has been changed to a plus (+) character. 


Note : that only characters with a 6b-bit display code 
representation can be given to JOBID.~ To produce a cotton (3) on 
output you should use a percent sign {(%) on inputs Unnecessary 
delimiters after the message data shoutd be omitteds otherwise a 
trailing delimiter may be printed. 


Automatic Date and Time Substitution 


Once JOBID has broken the message field into message tines based 
on the delimiter characters the front of each fieid is examined for 
the following sequences of characters : 


YDATE 
TIME 
YETAD 
YAMPM 
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11.0 JOBID - PRODUCE LARGE PRINT BANNER 


Whenever these character sequences are founds the message fine on 
which they occur is replaced with the current value of the indicated 
parameter. (NOTE that the right parenthesis must be the first 
character of the message line on which it occurs). 


The above "commands™ produce the following types of results : 


DATE 17 SEPT 74 
TIME 14218321 
YETAD 74/09/17 (date reversed) 
YAMPM 3:95 PM 
LOBIQExamoles 


GRAPL/OLDPL/ZTAPE =/ 7777 

TEXTJAB/COMPILE/ OF/)DATE/) TIME 
V/I77+CREATED ONt L7/O9/744+4LATEST RUNF+) DATE 
SEND TO/MEADGWVALE/ROOM 888 
/DAYFILE/DUMP/)ETAD 


The above calls produce the results shown below 3 


GRAPL TEXTJAB CREATED ON SEND TO 

OLDPL COMPILE 17/09/74 MEADGWVALE DAYFILE 
TAPE = OF ROOM 888 DUMP 

T7777 17 SEPT 74 LATEST RUN 74/09/17 


133235:26 18 SEPT 74 
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J1.0 TXTHEAD DOCUMENT. (HEADINGS) POSTIPROCESSOR 


Sometimes the header material generated by TXTFORM is not desired 
or TXTFORM is unable to produce a needed header format. The TXTHEAD 
utility processes a TXTFORM output files which contains special 
TXTHEAD instruction pages» and removes the oid header material 
and/or inserts the new heading material. Additionally» an 
incrementing page number can be produced at any position within the 
header texts or the TXTFORM nage number may be passed to TXTHEAD for 
placement into the header region. 


COMMANDS ACIION 

//77HEAD New heading material follows until another /// ts 
encountered in columns 29394. 

J#7/END Usuatiy marks end of special heading material. 

S//PAGEL—Inn Set page number for next page to nne If negatives 
the page number is not printed until it increments 
to le 

S/7L INENN Line nn of header on which to put a page number. 

J//COLUMNNA Cotumn position for units digit of page number is 


nns for TXTHEAD generated page Nno0Se» and for 
TXTFORM generated page numbers the column position 
specifies the tocation of the left hand side of the 


page number. (Count includes carriage control 
column). 

4/7 ADDNONN Number of header lines to be added is nn.w Oefault 
is add all tines given. 

77/DELETEnn Number of lines to be defeted from top of each page 
is An. 

J/79LDN9 Use the TXTFORM generated page nos. 

J77NEWND Use the sequentially generated TXTHEAD page nos. 


This is the default condition. 
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J1.0 TXTHEAD DOCUMENT CHEADINGS) POST-PROCESSOR 


To give these commands to TXTHEADs the following type of format. 
should be used in a TXTCODE document at the place where the change 
is to occur. 


Nasis 

\marginl 

Alength380 

\page 

/iihead 

1 KEKE KEKE EKEKERE 
* * 
* HEADER TEXT * 
* x Page 
KEKERKERER ERE ERRE 

fifend 

J/fpagel 

ffi tine3 

f/ficolumn65 

Vifdetete3 

\marginld 

\iength62 

\block 

\page 


Notes : 


Header information as well as any specifiable information may be 
defined or redefined anywhere. Did values remain set until 
replaced. The page number may be eliminated by specifying ///1ined 
or any out of range value. 


Any size header is permissibte. It is also possible to supply 
fotio information for pages by putting the page eject at some point 
after the first tine of header material. Column one of the header 
information is assumed to contain printer contro! characters such as 
"blank™s +5 -» Os» etce 


A great deat of flexibility ts available for special page 
formats. 
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K1.0 JABEQRM_ CONVERSIONS 


The following is a table of conversion performed by JABFORM 3: 


TEXTMAB 


oA 
~BxXaee0e09Z2Z- 
~BBXx»s eeesZ2Z- 
-/C- 

a 
~GXXee2029ZZ2Z—- 
~HN—YeV¥C oe el 


- IN- 
~KN= 
-N- 
-Nx= 


~VXX9ee0esZ2Z2- 

~VVXXxX9 200922- 

~J=- 

-~ (MINUS MINUS) 

“ANY COMBINATIONS OF EDIT CODES- 


IXTEORM 


\A 

\BXX9 000922 
\BBxxs 200922 
AC 

\E 

\F 

\GxXX9 e209ZZ 
\HN 

Coa et 

\IN 

\JN 

\KN 

AL 

\M 

\Nx 


\U 

\VxXXe 000922 

\VxXxXex 000922 

\XN 

\Z 

\ 

\COMBINATION OF CODES 
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K1.20 JABFORM CONVERSIONS 


TEXTJAB 


+ARABIC?t 
+AUTO+ 
+CARDLNXX+# 
+CHANGEsC+ 
t+DATEt XKXXXXX 


+DEPTHXX+ 
+DOUBLE+ 
+EIGHT+ 
+ENDT+ 

+FOL TO+XXXXXX 


+HEADA+ 
+HEADA=XX+ 
+HEADB+ 
+HEADB=XX+ 
+HEADC + 
+HEADC =XX+ 
+JUST+ 
*#LENGTHNN+¢ 


LIST (Xs ee. eXd*TITLE 


+MARGINXX+ 
+NOAUTO+ 
+NOJUST+ 
+NOPTAB+ 
+NOSEQ+ 
+NOSOQURCE+ 
+PTAB+t 
+RECORDXXs YY+ 


+ROMAN+ 
+SEQ+ 


IXIEORM 


discarded 

discarded 

\RECORD1 » Xx 

\CHANGEsC 

\DATE 

XXXXXX 

NFORMAT»s » XX 

VsPACE2 

discarded 

\ (See +¢TABLE+) 
\FOLIO 

XXXXXX 

VHEADA 

NHEADA (=XX discarded) 
VHEADB 

NHEADB (=XX discarded) 
\VHEADC 

\NHEADC (=XX discarded) 
A\just 

\LENGTHNN 

(After thiss JABFORM onfty processes 


column 1 thru NN3 NN#1 to EDL is passed 
-thru.)} 


ALISTK 9.009% 

TITLE 

(discards P= and R=) 
VMARGINXX 

discarded 

\NOJUST 

discarded 

\NOSEQ 

discarded 

discarded 
VRECORDXXs YY 

(After thiss JABFORM only processes 


columns XX thru YY3 column 1 thru XX-1 
and YY+1l to EOL will be passed thru.) 


discarded 
\VsSEQ 


COMPANY PRIVATE 


CDC - SOFTWARE ENGINEERING SERVICES 


SES {Release 17) Userts Handbook 


PH PD OD PE PE 18 FE 8 UE PE F878 8 88 WE PE 8 20 8 FO 08 26 28 


K1.0 JABFORM CONVERSTONS 


REV: 


K1-3 


7/30/78 
AB 


Ce ee ee ke Be Re Be Be Be Be Bee Bid Me Ri Bi he Bee dt tad okie d et Kidda dnded 


TEXTJAB 
+SETAtC 


#SETC+C 
+SETE+C 


+SETQ+C 


#SETS+C 


+SETU+C 


t+SETTABLEXXs oe as L5S2=ZZ+ 
+SINGLE+ 

+S1X+ 

+SDURCE+ 
+SUBTITLE+XXXXXX 


#TABLE+ 


+ TITLE ¢XXXXXX 
+TODAY+ 
¥*C 


*CreeC*® Capostrophies) 
$CoeelS 


IXTEORM 


discarded 
(JABFORM recognizes 


the C as 


aiter code from now on.) 


discarded 

discarded 

(JABFORM recognizes 
code from now on.) 

discarded . 

{JABFORM recognizes 
capitalize string code 

discarded 

(JABFGRM recognizes 
specia! character code 

discarded 

{JABFORM recognizes 


the ¢C as 
the C as 
from now 


the C as 
from now 


the C as 


an 


an edit 


One) 


the 
one) 


the 


undertine string code from now on.) 


NSETTABLXX9 20091572 
\sSPACE1 

discarded 

discarded 

ATITLE2 

XXXXXX 

\COMMENT 


+TABLE+ (Input thru next endt is not 
processeds but passed to TXTFORM as a 


comment shifted to the right one 


space.) 
+ENDT+ 
\ 
\TITLE1] 
XXXXXX 
\TODAY 


*C {CC is not capitalized - ASCII 
64/12 TEXTJAB input does not use this 


feature.) 
Coeel (capitalized) 
\UNDER 
Ceeel 
\UOFF 
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K1.0 JABFORM CONVERSIONS 


TEXTIAB 


4A 
1B 
7¢ 
70 
VE 
JF 
46 
/H 
| 
‘J 
1K 
fL 
‘™ 
iN 
49 
#P 
/Q 
/R 
‘Ss 
77 
1U 
‘Vv 
‘W 
1X 
VY 
42 
/0 
41 
42 
43 
44 
45 
16 
17 
/8 
49 


IXTEQRM 

+ (ptus) 

1] {ctosing bracket) 

' (single quotes grave accents or closing quote) 
% {dollar sign) 

3 (semicolon) 

> {greater than) 

< (tess than) 

+ (plus) 

\BLANK1 


%, 


(underline) 
(percent) 


{unknown - blank) 


DON OU SWE O™ F Hw Mt me oe | © @ KH HH ce MM 


{(ampersand) 
(exclamation) 
(equal) 
{asterisk) 
(commercial at) 
(apostrophe or opening quote) 
{minus) 

(colton) 

(pound) . 

{opening bracket) 
{question) 
(asterisk) 
{quotation marks) 
(stant) 
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K1.0 JABFORM CONVERSIONS 


TEXIJAB IXTEQRM 
(spaced ..f \COMMENT 
Cael 

/* * (asterisk) 

i * {single quotes grave accents or closing quote) 

j~- - (minus) 

s+ + (pilus) 

1% $ (dollar sign) 

4T { flopening bracket) 

a | 1 (closing bracket) 

7” " (quotation marks) 

474A + (plus) 

478 } (closing brace) 

smc “ (clrcumflex) 

470 * (singie quotes grave accents or closing quote) 

JHE ' {apostrophe or opening quote) 

47F \ (reverse stant) 

176 a {commercial at) 

44H + (plus) 

M71 (space) 

473 + (plus) 

4a 2 (vertical tine) 

aA - (minus) 

47™ ; vertical line) 

77N ” (tilde) 

470 * {quotation marks) 

77P {space) 

779 (space) 

77R {space) 

178 (space) 

477 {space) 

4770 + (plus) 

V/V { (opening brace) 

4/wW * (asterisk) 

44x * (asterisk) 

FIX + {pius) 

442 \ (reverse stant) 

44 / (stant) 

446 & (ampersand) 

NOTES 3 

1) If JABFORM is passing columnss unprocessed data in the passed 
columns on input is in the same colfumns on output. Blank 
paddings when requireds is done to accomplish this. 

2) All TXTFORM codes are put on a tine by themselves. 
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3) ALL TEXTJAB codes (except +TABLE+) that have no  TXTFORM 
conversion is converted to EDL and a message sent to ERRFILE. 


CAUTION 3 


1) The TEXTJAB source XXX '"YYY* converts to 3 
XXX 
\NUNDER 
YYY 
\VUOFF 
Which lists as XXXYYY. To get a space before the first Ys» the 
TXTFORMA source must be changed to have a space before the Y. 


2) TXTFORM can oaonty handie tine length up thru 100 characters on 
output and TEXTJAB allows 120. This means the -+#LENGTH+ code 
witli convert OX» but TXTFORM will not process correctly. 


3) TXTFORM can onty handie tab settings up thru 99 and TEXTJAB willl 
handie 119. This means a TEXTJAB SETTAB alter code will convert 
OKs but TXTFORM will not be able to handle it correctly. 


Example 3: 
+SETTAB7=10358"*113+ 
This will convert to : 


NSETTAB710328113 - with tab number 71 and 81 with columns of 3 
and 13. 
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L1.0 CHARACTER _SET TABLE CUSED BY CONV) 


The following tabie shows the ASCII characters and the internal 
octal codes that represent them within the various character sets 
that are processed by the CONV utility. 
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ASCII 
GRAPHIC — N63 


a 


2 (COLON) 63 


ia) 
wo 


N64 


00 


N612 


NBE63 


63 
01 
02 
03 
04 
05 
06 
07 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
43 
44 


NBE64 


User's Handbook 


NBE63A 


072 
101 
102 
103 
104 
105 
106 
107 
110 
11i 
112 
113 
114 
115 
116 
117 
120 
121 
122 
123 
124 
125 
126 
127 
130 
131 
132 
060 
061 
062 
063 
064 
065 
066 
067 
670 
O71 


Li-z 


7/30/8 
REV: AB 

ASCI1I4 

NBE64A ASCII5 
072 072 
101 101 
162 102 
103 103 
104 104 
105 105 
106 106 
107 107 
110 110 
111 111 
112 112 
113 113 
114 114 
115 115 
116 116 
117 117 
120 120 
121 121 
122 122 
123 123 
124 124 
125 125 
126 126 
127 © 127 
130 130 
131 131 
132 132 
060 060 
061 061 
062 062 
063 063 
064 064 
065 065 
066 066 
067 067 
070 070 
071 071 
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ASCII 
GRAPHIC N63 
+ (PLUS) 45 
- (MINUS) 46 
* (ASTERISK 47 
/ (SLASH) 50 
( (LEFT PAREN) 51 
) (RIGHT PAREN) 52 
$ (DOLLAR SIGN) 53 
= (EQUAL) 54 
(SPACE) 55 
» (COMMA) 56 
» (PERIOD) 57 
# (POUND) 60 
{ (LEFT BRACKET) 61 
} (RIGHT BRACKET) 62 
% (PERCENT) - 
* (DOUBLE QUOTE) 64 
— (UNDERLINE) 65 
! (EXCLAMATION) 66 
& CAMPERSAND) 67 
* (APOSTROPHE) 70 
? (QUESTION) 71 
< {LESS THAN) 72 
> (GREATER THAN) 73 
@ (COMMERCIAL AT) 74 
\ (REV. SLASH) 75 
* (CIRCUMFLEX) 76 
3 (SEMICOLON) 77 


N612 


45 
46 
47 
50 
51 
52 
53 
54 
55 
56 
57 
60 
61 
62 
63 
64 
65 
66 


NBE63 


45 
46 
47 
50 
31 
52 
53 


NBE64 


45 
46 
47 
50 
51 
52 
53 
54 
55 
56 
57 
60. 
61 
62 
63 
64 
65 
66 
67 
70 
71 
72 
73 
74 
75 
76 
77 


NBE63A 


053 
055 
052 
057 
050 
051 
044 
075 
040 
054 
056 
043 
133 
135 
042 
137 
041 
046 
047 
077 
O74 
076 
100 
134 
136 
073 


REV: 


NBE64A 


053 
055 
052 
057 
050 
051 
044 
075 
040 
054 
056 
043 
133 
135 
045 
042 
137 
041 
046 
047 
077 
074 
076 
100 
134 
136 
073 
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ASCII4 
ASCII5 


053 
055 
052 
057 
050 
051 
044 
075 
0490 
054 
056 
043 
133 
135 
045 
042 
137 
041 
046 
047 
O77 
074 
076 
100 
134 
136 
073 
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N612U 


45 
46 
47 
30 
a1 
52 
33 
54 
35 
56 
57 
60 
61 
62 
63 
64 
65 
66 
67 
70 
71 
72 
73 
7401 
75 
7402 
77 


Né 


74 


74 


Li=< 


G SERVICES 
7/30/78 
ASCII4 

4 NBE63A NBEOSA ASCII5 N612U N612L 
072 072 072 7404 7404 
101 101 101 01 = 
102 162 102 02 = 
103 103 103 03 = 
104 104 104 04 - 
105 105 105 05 = 
106 106 106 06 = 
107 107 107 07 = 
110 110 110 10 = 
111 111 111 il “ 
112 112 112 12 = 
113 113 113 13 = 
114 114 114 14 = 
115 115 115 15 a 
116 116 116 16 
117 117 117 17 - 
120 . 120 120 20 = 
121 121 121 21 = 
122 122 122 ee = 
123 123 123 23 = 
124 124 124 24 = 
125 125 125 25 = 
126 126 126 26 aad 
127 127 127 27 = 
130 130 130 30 = 
131 131 131 31 * 
132 132 132 32 = 
060 060 060 33 33 
061 061 061 34 34 
062 062 062 35 35 
063 063 063 36 36 
064 064 064 37 37 
065 065 065 40 40 
066 066 066 41 41 
067 067 067 42 42 
070 070 070 43 43 
071 O71 O71 44 44 
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4 NBE63A NBE64A ASCII5 N612U N612L 
053 053 053 45 45 
055 055 055 46 46 
052 052 052 47 47 
057 057 057 50 50 
050 050 050 a1 51 
051 051 051 52 52 
044 044% 044 33 53 
O75 075 075 54 54 
040 040 040 55 55 
054 054 054 56 56 
056 056 056 57 57 
043 043 043 60 60 
133 133 133 61 61 
135 135 135 62 62 
aa 045 045 63 63 
042 042 042 64 64 
137 137 137 65 65 
041 041 041 66 66 
046 046 046 67 67 
047 047 047 70 790 
077 O77 077 71 71... 
074 074 074 72 72 
076 076 076 73 73 
100 100 100 740 7401 
134 134 134 75 75 
136 136 136 7402 7402 
073 073 073 77 77 
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ASCII ASCII4 
GRAPHIC N63 N64 N612 NBE64A ASCII5 N612U 
a 7601 141 - 
b 7602 142 = 
c 7603 143 - 
d 7604 144 - 
e 7605 145 - 
f 7606 146 - 
) 7607 147 - 
h 7610 150 - 
i 7611 151 ~ 
j 7612 152 _ 
k 7613 153 - 
i 7614 154 - 
m 7615 155 - 
n 7616 156 - 
o 7617 157 - 
p 7620 160 - 
q 7621 161 - 
r 7622 162 - 
s 7623 163 - 
t 7524 164 - 
u 7625 165 - 
v 7626 166 - 
w 7627 167 - 
x 7630 170 - 
y 7631 171 - 
z 7632 172 - 
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ASCII4 
* NBEO3A NBEG4GA ASCIIS N612U N612L 
141 “= 7601 
142 = 7602 
143 = 7603 
144 = 7604 
145 = 7605 
146 = 7606 
147 cad 7607 
150 = 7610 
151 = 7611 
152 = 7612 
153 = 7613 
154 = 7614 
155 < 7615 
156 = 7616 
157 a 7617 
160 = 7620 
161 = 7621 
162 = 7622 
163 = 7623 
164 = 7624 
165 = 7625 
166 ~ 7626 
167 = 7627 
170 = 7630 
171 a 7631 
172 - 7632 
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ASCII 
GRAPHIC N63 N64 


{ (LEFT BRACE) 
3 (VERTICAL BAR) 
} CRIGHT BRACE) 
" (TILDE) 

DEL 

NUL 

SOH 

STX 

ETX 

EOT 

ENQ 


“ (GRAVE ACCENT) 


N612 


7633 
7634 
7635 
7636 
7637 
7540 
7641 
7642 
7643 
7644 
7645 
7646 
7647 
7550 
7651 
7652 
7653 
7654 
7655 
7656 
7657 
7660 
T7661 
7662 
7663 
7664 
7665 
7666 
7667 
7670 
7671 
7672 
7673 
7674 
7675 
7676 
1677 
7407 


7430/8 
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ASCII4 
NBE64A ASCII5 


173 
174 
175 
176 
177 
000 
001 
002 
003 
004 
005 
006 
007 
010 
O11 
012 
013 
014 
015 
016 
017 
020. 
021 
022 
023 
024 
025 
026 
027 
030 
031 
032 
033 
034 
035 
036 
037 
140 
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N612U 


7633 
7634 
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173 7633 7633 
174 7634 7634 
175 7635 7635 
176 1636 7636 
177 7637 7637 
000 7640 7640 
001 7641 7641 
002 7642 7642 
003 7643 7643 
004 7644 7644 
005 1645 7645 
006 7646 7646 
007 T647 7647 
010 7650 7650 
011 7651 7651 
012 7652 7652 
013 7653 7653 
014 7654 7654 
015 7655 7655 
016 7656 7656 
017 7657 7657 
020. 7660 7660 
021 7661 7661 
022 7662 7662 
023 7663 7663 
024 7664 7664 
025 7665 7665 
026 7666 7666 
027 7667 7667 
030 7670 7670 
031 7671 7671 
032 7672 7672 
033 7673 7673 
034 7674 T7674 
035 T7675 7675 
036 7676 7676 
037 7677 7677 
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M1.0 MECHANISM_FOR_ COLLECTING USER SUPPLIEO SOFTWARE 


This mechanism defines when and how SES makes user developed 
software tools availabile to the entire SES user community. The 
mechanism is based on the assumption that it is beneficial to gather 
tools devetoped by peopie outside the SES organization into a 
commons known tocation. 


Mlel QBIAINING _USER_SOETWARE 


The user supplied software which is assembled and made available 
by SES falls into the area generally considered as "toots”. It is 
sufficiently general purpose so it is useful to people other than 
the originator. It is comprised of SES proceduress programs or 
modules. 

Software supplied by a user is totatty transferable to another 
catalog. It is not dependent on any developer's catalogs or any 
catalog other than the one the tool itself resides in. If the 
software being supplied is a program or modules the source code is 
supplieds along with a  buitd procedure that Is also totality 
transferable to another catalog. The author can request the source 
remain unaccessible to other userse 

In addition to the actual software, the user submits the 
following documentation: 

A) <A short description of the tools which is kept in an online 
directory of user supplied toots along with the supptier'’s 
names tocation and extension. 

B) Documentation on how to use the software. The more 
compfete it is» the fewer phone calls the supplier 
receives. 

C) SES procedures contain HELP documentation that assist 
someone in using the procedures 


Mle2 MAKING USER SOFTWARE AVAILABLE THROUGH. SES 


When SES obtains user developed softwares it is handied in a way 
Similar to SES developed software. Procedures are collected on a 
procedure tiobrary catted USSPLIB in the SES cataloge Binary files 
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are assigned USS numbered files» and are kept in the SES catalog. 
The source for user supplied software is cottiected onto a 
semi-private SCU PL called USSPL and kept in the SES catalog. If 
the author requests that it not be accessibles the source is kept in 
a private SES file. 

The major advantage of maintaining user supplied software is the 
SES catalog is than any changes or new software are automatically 
sent to the sites receiving the reguiar SES updates. 


M1.3 COMMUNICATING AVAILABILITY _OF_USER_ SUPPLIED SOFTWARE 


An ontine directory (USSINFO) of user supplied tools is 
maintained on the SES catalog. This file contains a short 
description of the tool provided by the developer. This description 
js also circulated via the Advanced Systems Development Productivity 
Circle and/or the SES Toots Bulletin. 

Hard copy documentation supplied by the user is available from 
SES on request or online via TOOLDOC. 


M1.4 SUPPORT_QE_USER_ SUPPLIED SOFTWARE 


All correctionss Improvements or other modification to user 
supptied software are the responsibility of the person supplying the 
software. SES does not support any user supplied software. 

If software supplied by a user is standardized (it becomes a SES 
supported product) it is removed from the user supplied category. 
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166 PROFILE =_ SETTING UP_YOUR_ LOCAL ENVIRONMENT 


A PROFILE is a file where you can piace information about you and 
the things you're currently working on, Many SES procedures use 
information out of the PROFILE to set up defaults for frequentty 
used thingss such as the name of an object tibrary. Having a 
PROFILE can save you much time since you don't have to code 
parameters for information that's already in the profile. 


If you want to have a profiles you should create a file called 
PROFILE which has the word PROFILE as the first line of the file. 
The most important and useful pieces of information to place in your 
profile are your passwords charge number and project number. Thus» 
your initial profile shoutd have (at least) the following in it: 


PROFILE . 

\ passwor = "your _password* 

\ charge = "your_charge_number? 
\ project = "your_project number! 


An easy way to set up an initial PROFILE for yourself is to call 
the BuilD PROFile (BLOPROQE) procedure tike this : 


sesebidpr of 


BLDPROF prompts you for the most common items to be placed in your 
profile. In additions it creates a MAILBOX for yous For 
information on the “maii™ facilities of SES» see chapter 12.0 - 
"USER TO USER COMMUNICATIONS", 


SES suppties a procedure calied IAFs which sets up defaults for 
particular terminal types. BLDPROF prompts for your terminal types 
and places that information in your profile. For further 
information on IAFs see the IAF procedure description in the 
“miscellaneous useful goodies“ chapter. 


BLDPROF wilt also ask you for your graphics terminal type which 
may be different than your usual terminal. Even if you use the same 
terminal for graphic (CADSG) and non-graphic works you should answer 
both requests. BLDPROF will ask additional questions about your 
graphics terminal - baud rates hard copy avaitabies and _ =~*for 
TEKTRONIX 4014 Extended Graphics Module and synchronous or 
asynchronouse For further information on CADSGs see the CADSG 
procedure description in the Structured Process Toots chapter. 


There are many other things that may go into your profile. These 
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are mainly concerned with source code maintenance and tibrary 
management functions and so one. These other aspects of profiles are 
discussed in the chapters dealing with the specific subjects. 


Another useful thing that can go into a profile is SES directives 


that specify which procedure tlibrariess and wheres to search for. 
procedures. The SEARCH directive is discussed in appendix A. 
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1.7 SES.PROCEQURES._RUN_AS_ BATCH JOBS 


Instead of running Interactivelys or "while you wait" at your 
terminals, many SES procedures can be submitted to run in the 
background as batch jobs. You do this by coding a key (batch or 
batchn or defer) which causes the framework of a batch job to be 
built around the specified procedures then SUBMITs the file so built 
to NOS as a batch job. 


Using SES in this way is often very effectives especially where 
the job to be done uses tots of resources. By running the job in 
batch» you can proceed with your interactive session instead of 
having to wait. 


For such procedures» the list of parameters described betow are 
those which affect the running of the batch job. Note that these 
Parameters are ogniy applicabie if you run the procedure in batch 
mode (that is» non-local). 


jobun : 

{optionat) JOB User Name to be used on the USER statement 
of the batch job. If you don't code the jobun parameters 
the job is built with the user name of the current user. 
Note =: that in some NOS sites» it is not oassible to 
SUBMIT a job to run under another userts account. The so 
calied "secondary user" statment is disabled. If 
secondary user statements are disableds and you try to 
submit a job for another accounts you get Logged off! 


jobpw : 
(optional) JOB PassWord to be used on the USER statement 
of the batch job. If you don't code the jobpw parameters 
and there's no passwor variable defined in your profile 
{see the section on profiles)», SES asks you for your 
password in a similar manner to that of NOS. 


jobfmiy : 
(optional) JOB FaMiLY to be used on the USER statement of 
the batch job. If you don't code the Jjobfmly parameters 
and there's no family variable defined in your profile 
{see the section on profiles)» the family name for the 
current user is used. 
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jobcn 


jobpn 


jobft 


jobtt 


jobpr 


oe 


(optional) J0B Charge Number to be used on the CHARGE 
statement of the batch job. If you don't code the Jjobcn 
parameters and there's no charge variable defined in your 
profile (see the section on profiles)» SES asks you for 
your charge numbere 


(optional) J0B Project Number to be used on the CHARGE 
statement of the batch job. If you don't code the jobpn 
parameters and there's no project variable defined in your 
profite (see the section on profiles)» SES asks you for 
your project number. 


(optional) specifies the JOB Field Length to be used for 
running the job. You don't normatiy need to code the 
jobfl parameters since afi the procedures which run in 
batch set the FL to the required vatue.s. If you want to 
specify the job field tenagth as an gctal numbers you gust 
add the (8) suffix to the numbers because SES treats 
numbers as decinal untess told otherwise. 


(optional) specifies the JOB Time Limit to be used for the 
job. This is always the same for allt’ procedures» namely 
200018). If you need more time for the jobs you must code 
some vatiue for the jobti parameter. If you want to 
specify the job time timit as an ogctal numbers you must 
add the (8) suffix to the numbers, because SES treats 
numbers as decimal uniess totd otherwise. 


(optional) specifies the JOB PRiority (that iss the P 
parameter on the NOS job statement). If you want to 
specify the job priority as an octal numbers you gust add 
the (8) suffix to the numbers because SES treats numbers 
as decimal uniess told otherwise. 


(optional) BIN number parameter used at Sunnyvale 
Development Division to indicate which "bin™ the job output 
should go ine The bin parameter is coded in the form of a 
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strings for example : binz"*7h*. You can aiso define a 
userbin variable in your PROFILE (Usee the section on 
profiles)», so that the. bin number is picked up 
automatically.» SES generates a large print banner of your 
bin number on the front of the job outputs and aiso places 
the bin number In the job name field of the job statement. 
If you don't code the bin parameters and there's no userbin 
variable defined in your profiles SES generates a bin 
number of NOQ-IDs which almost certainty gquarntees that your 
job output ends up in the NOS/WO BIN NUMBER bin. 


focal or batch or batchn or defer : 

coding one of these (optional) keys determines the mode in 
which the procedure or job is to be rune Coding the tocal 
key runs the procedure LOCAL to your terminals or while 
you waite Coding the batch key issues a SUBMIT with 
option 8B for the SUBMIT statement. Coding the batchn key 
issues a SUBMIT with the N option for the SUBMIT 
statement. Coding the defer key DEFERS the job for after 
hours runninge You can find all the gory details of the B 
and N parameters for SUBMIT in the NOS reference manual. 


ogee or dayfite or df 3. 
this (optional) parameter applies to some of the 
procedures that can be run as batch jobs. Each procedure 
description (for procedures which can run as batch jobs) 
specificaily mentions this parameter only if the procedure 
makes use of it. For those procedures that do use its 
this parameter applies oniy if the procedure is run as a 
batch job {that ts» non-focai)d. If you dontt code the 
parameter at alls or if you simply code dayfile or df» if 
the job hits an EXIT statement due to errorss the job 
dayfile is dumped to a file called dayfiles, which is 
placed in your catatog when the job terminates. If you 
code dayfilesfilename or dfzfilenames the dayfile is 
placed in your catatog in a file of name filename. If you 
code the nodayf options no dayfile ts produced at job 
ende The diagram below provides a more graphical 
explanation of the interactions of the dayfile parameter. 


COMPANY PRIVATE 


1-20 
CDC - SOFTWARE ENGINEERING SERVICES 
7/30/81 
1.0 INTRODUCTION 
1.7 SES PROCEDURES RUN AS BATCH JOBS 


; dayfilesfite. name 
: or dfz=file name Job dayfile dumped to file file name if any 


errors occur during the job. 


Job dayeiie is nat duapea even if errors 
occur dees the gobs 


She a ee fe ee ee + 
; Coded Qo ; H 
; Procedure ; Action Takeo : 
$e wo ee fp ee ae ee ee eee + 
H Nothing + Job dayfile is dumped to file dayfile if any ! 
; :; @rrors occur during the dsb. H 
$ ee ee ee ee ee Bh ee ee + 
; dayfite or ; ‘ 
; df key H H 
: onty : Job dayfile dumped to file dayfilte if any 3} 
$ errors occur during the job. ; 
fp a a a ae en ae ee at ae ae Sa ee ee a en} 
: ; 
H H 
2 2 
3 2 
+ + 
: : 
s a 
E 4% 
+ + 


Nate : that onty those procedures whose descriptions contain a 
reference to the parameters Scorched above can be run as batch 
jobs. 


Exampie of Batch Usage 


A fairly widely used SES procedure is LISTMOD (which supplies a 
cross reference and a printout of the modules in a base ~- see the 
chapter relating to source text maintenance). LISTMOD runs "white 
you wait™ by defaults and since it grindss it's much better to run 
it batchs like this ; 


seselistmod bzsnewdatas batch 
15.00.19. SUBMIT COMPLETE. JOBNAME [S AFTQBXT 
* JOB LISTMOD SUBMITTED 


This example shows a simple usage of LISTMGD run in batch by coding 
the batch key. The exampte assumes that your passwords charge 
numbers project nunber and all are defined in your PROFILE as 
described eartier. The message is returned by NOS : it's the time 
of day that your job was submitteds and the so called job name. The 
fast message about job submitted comes from SES. 
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1.27.1 PROFILE VARIABLES FOR CONTROLLING BATCH MODE 


SES procedures that can optionaily run in batch mode may be 
controlled by the settings of certain variables in your PROFILE. 
This makes it easier to use SES all rounds since you don't then have 
to supply the information every time you use a procedure. The set 
of directives below can be coded into your profile if you wishe 


PROFILE 

\ passwor = "your_password' 

\ charge = *your_charge_number* f 
\ project = *your_project number * 
\ family = "your_famity® 


passwor defines your password 


charge defines your charge number. 


project defines your project number. 


family defines your family name. 


Note : that if your validation on the system is such that you do 
not require a CHARGE statement in batch jobs or when you tog in at a 
terminals you should set the charge and project variables to nul! 
(empty?) stringse This inhibits the generation of the CHARGE 
statement by SES for batch jobs. 
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Examptes of PROFILES 


PROFILE 

\ passwor = *ASTERIX® 
\ charge = "QBELIX® 
\ project = *GETAFIX® 


That is an example of a minimal PROFILE.} Here's a typical PROFILE 
as it might be defined for a user at Sunnyvale Development 
Division 3: 


PROFILE 

\ passwor = *WABBIT® 

\ charge = ## 

\ project = 

\ userbin = *21E8 

\ myname = "Lorenzo Desmondo Of *Hare® 


Note that the charge and project variables are set to empty strings 
- at the time of writings SDD doesn't require CHARGE statements = on 
NOS. 
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1.8 INEQRMATIVE_ MESSAGES _EROM_SES_ PROCEDURES 


Many SES procedures are set up such that when they run "while you 
wait™ at the terminals they output informative messages to tell you 
what they're doing. The informative messages are controlled by a@sg 
and nomsg keys on the appropriate procedures. The normal defaults 
in the absence of any other information is for the procedures to 
output informative messages. Coding the nomsg key suppresses the 
messages Howevers it is possibte to establish your own default by 
defining a profile variable catied msgctri. The msgetri variable 
can be defined in one of two ways 3 


\ msgcetri = t*? this sets the normal default for informative 
messages to no messagese In order to obtain 
messages from procedures the msg key must be 
coded on the procedure call. 


\ msgcetri = *SESMSG.*' this sets the normal default to output 
informative messages. To turn messages offs 
the nomsg key must be coded on the procedure 
call. 


The table below should give a more graphical idea of the 
interactions of the msgctri variable and the msg and nomsg keys on 
the procedures. 


$e ee ee + 

H QEEINED IN PROEILE ; 
$ 2 ee $$ ween ee $n na oe ee ooo + 
+ Ceded Qo i: Nothing + \ MSGCTRL=*SESMSG.*! : \ MSGCTRL=Oe® : 
: Procedure 3: : : ; 
oe $$ me ee $m ee ne ee eee $e enn wn ne ee ~—+ 
+ Nothing +: Messages 3 doceagee H No Naceqgee H 
$e ee a $n ene pow nnn we ee + 
+ MSG $3; Messages $ Messages H Nessages H 
or $$ eee ane ee $e ee ee ee ee ee ee eee $e en nn wn oe ne ne ne + 
+ NOMSG 73 No H No heccuges : No Messages ;3 
: +: Messages 3; H H 
$e ee $ $e ee $e ne ee ee O_o + 
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1.9 GENERAL_NOTES _ON_SES_PROCEDURES 


SES procedures ares in generals written to do the detail work for 
yous», so you can concentrate on the job at hand. Let's look at the 
workings of a typical. SES procedure - COPY ASCII Coded Record 
({COPYACR)», to see what it does : 


sesecopyacr izinput_ files ozoutput_file 
*. END COPYACR INPUTLFILE <-> OUTPUT_FILE 


The COPYACR procedure emits NOS control statements to do the 
following :; 


acauirce the input_file (see the note on ACQUIRE below) 
acauire the program (tool) that does the COPYACR process 
ceturn the output_file 

COPYACR from input file to output file 

ceturn the COPYACR program 

cewind both the input _file and the output file 


you may if you wishs use procedures such as COPYACR tike this : 


sesecopyacr file _to_be_ processed 
* END COPYACR FILE_TO_BE_PROCESSED 


In such casess where does the output of the procedure go? Well it 
certainiy doesn't go to file output (the terminal). In such cases» 
the output file eventually replaces the input file : . 


acaguice the file _to_be_processed 
acguire the COPYACR program (tool) 
COPYACR file_to _be_processed to a unique _named_temp_file 
ceturo the COPYACR program 
* rename file _to_be_processed = unique -named_temp_file 
cewind unique_named_temp_file 


There are many SES procedures that function this way - they are 
often referred to as FILTERS - a process that copies an input to an 
output with some (one would hopes useful) transformation in 
between. . 
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ACQUIRING Eiles_in_ SES Procedures 


When you call up an SES procedure to 3 
sesedo_some_process itinput_files ozoutput_File 


one of the control statements emitted by the procedure is a 
statement to ACQUIRE the input _ files which means 3. 


le. if there's a LOCAL file of the required names REWIND that file 
and use it as the input _file. 


Ze otherwise ATTACH or GEI a permanent File of the required name 
from the current user's catatog. 


Ali this means you don't haye to care whether or not files are 
local <- SES procedures grab whatever is available under that name - 
that is what ACQUIRE is alt about. There is a full description of 
the ACQUIRE utility in Appendix E. 


The foregoing has some interesting effects which you should be 
aware of however. Consider the following sequence ;: 


sesefiles3; catlist 
WORKeece eeel2 PT. 
CATLIST OF WCN ( 9 FILESs 2685 PRUS ) 
MAILBOX I SP A eeel OGLOUSER D PU R 1127 PNTSORS D PU R .105 
PROCLIB D SP R 124 PROFILE I PR R wool PROGLIB D PU R 2.835 
SEVENee I PU R eoe2 STATSES D PU W 485 USERDIR I PU R ceed 
* END CATLIST 


sesepack izstatses 
* END PACK STATSES 


sesefiies 
WORKeee eovol2 PT. STATSES --481 LO. 
* END FILES 


Note that we PACKed file STATSES. Note that originallys STATSES 
was a PERMANENT DIRECT ACCESS files By the time the PACK process 
finished howevers the PACK procedure (because of the RENAME process 
described earlier) has now fteft a LOCAL file of the same name. SES 
procedures don't» in generals rewrite permanent files. Those that 
do say so explicitiy. 
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Using. SES_Procedures_in. Batch 


If you foliowed the description of the behavior of SES procedures 
aboves you may take note that SES is designed primarily as an 
INIERACIIVE tool. You gan use SES in batch job streams if you wishs 
but you should be aware that SES procedures don'ts» in generals make 
a special case of files INPUT and QUIPUTIs» whereas NOS does make a 
special case of files INPUT and QUIPUI. Usuallys when using SES 
procedures interactivelys you don't use QUIPUTI as the output file 
from proceduress those procedures that do use INPUT or QUIPUI say 
$O»s and take special note of those files. <All this means that if 
you run SES in batch streamss and use files INPUT or QUIPUI as input 
or output to procedures» you'fre tikely to tose a tot of output 
because SES procedures REWIND or RETURN things. Sos to avoid griefs 
uses files other than INPUT and QUIPUI. 


Unique Names_in_SES_orocedures 


When SES buiids the JCL stream from an SES procedures programss 
scratch files and so on are usually given unique namess so that you 
don't have to care which names are reserved by each particular 
procedures These SES generated unique names are always seven 
characters tongs always begin with the letters ZQsxs and are aiways 
guaranteed to be different from the name of any file currently 
assigned to the running job. This note is for your informations 
just in case you ever took at a dayfile where SES procedures have 
been used,» and see fots of funny looking names.e. The example  betow 
shows the JCL generated by the sesetlimits procedure. 


$RFL(20000) 

STFC FILECOUTPUTs AS) ISRENAME ( ZQWTBQ620UTPUT) 
SASSIGN(MS s OUTPUT) 

SLIMITS. 

SRENAME (ZQWT8QQ=DUTPUT) 
SIFCFILECZQWT8Q65 AS) PSRENAME COUTPUT=ZQWT8Q6) 
SREWIND(ZQWTSRA) 
EDTCZQWT8QQs ZQWT SRA» ZQWTSRW) 
SRETURN(ZQWTBRAs ZQWT SRW) 

SCOPYBR(ZQWT8QQ5 OUTPUT) 

SRETURN(ZOWT8QQ) 

$RFLCO) 

* END LIMITS 
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1.10 PROCEDURE_DESCRIPTION_CONVENTIONS 


The remaining chapters of this handbook describe SES procedures 
that are currently availabie.» Each procedure description contains a 
bist of parameter descriptions}; and the order in which the 
parameters are described specifies their positional significance 
within the procedure. 


Onty those procedures that make references in their parameter 
lists» to the “batch job parameters” {see section 1.7 - ™SES 
PROCEDURES RUN AS BATCH J088S") can in fact be run as batch jobs. 


If a procedure description does not contain a description for a 
Parameters that procedure does not have such a parameter, 


If a parameter description does not explicitly specify that a 
parameter is optional then the parameter must be supplied when the 
procedure is called. 


In order to reduce redundancy within procedure descriptionss some 
of the features provided by a procedure are discussed in the 
descriptions of particular parameters; therefores we strongly 
recommend that w#hen you read a procedure descriptions you read the 
whole thing. 


Before you read a particular procedure descriptions we strongly 
recommend that you read the introductory subsection of the chapter 
containing the procedure description. Such things as general 
parameter descriptionss profile usages and naming conventions are 
discussed in those subsections. 


COMPANY PRIVATE 


1-28 
CDC - SOFTWARE ENGINEERING SERVICES 
| | 7/30/81 
1.0 INTRODUCTION 
1e1l HELP MODE 


PE ODIO OE PE PE POPE PE OD PE RE OO PO PO 8 PE PE OE DE FO OE PF PE PA OE PE PEPE BD PO 8 PE TE PO PE PE TE D8 FE PA DE OO OB DE PEPE PEPE OS PE DE Pt AE TE PO 88 8 OE PE OE 80 08 ON PO BE 
1.11 HELP_MODE 


SES provides a mode of operation of procedures that produces 
descriptive information about the specified procedures The 
information includes a one or two sentence description of what the 
procedure does plus a list of the parameters, their defautts» and 
the permissable values. In additions» required parameters are 
"flaaged” with (R) and defaults that are controtiable by PROFILE 
variables are “filagged™ with an *. To get the help documentation 
for a procedure listed out on your terminals you simply type : 


sesshelp.procedure_name 


Notice that no parameters are givens SES responds by displaying the 
help documentation for the named procedure (if any is avallabie). 
For example ? 

sesshetpecybil 
produces 3 


CYBIL compiles CYBIL source using either the CC or CI compiler. 
Parameters are? 


~-- PARAMETER ~~ nnn nnn nn - DEF AUL Tem mmm ALLOWABLE VALUE(S)---— 
isf COMPILE filename 
i LISTING filename 
b LGO filename 
ccsch *CC=SES keywordzusername 
chk NeRsS Nefss or no 
to I Cefsosismeawer 
debugsdsnodebug NODEBUG keyword or (STsDS) 
pad none 1 ese targe reasonabte number 
opt 0 0 or 1 (CI onty) 
ASgsNomsg *MSG keyword 


“HELP FOR CYBIL ON FILE OUTPUT- 


Note =: that help mode is not intended as a training mechanism or 
a tutorial for new SES users - that's what this SES User's Handbook 
is for - help mode is there as a "memory jogger” for more 
experienced SES hackers. 
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1.12 PRESRELEASE_VERSLONS_OF_ TOOLS 


SES provides a convenient and consistent method for accessing 
pre-release versions of SES supplied tools. To access the 
pre-release version of a procedures you simply type 3 


Sessssseprocedure_name list_of. parameters 
If there is a ore-release available for the specified tools it 
executes. If there is no pre-release versions you get the standard 


release version. 


If you atways want opre-retease versions of tools that are 
available» you can place in your PROFILE the following directive :; 


\ SEARCHs USERs SSS» SESUNAM 
This tetis SES to first took in the current user's catalog for the 
specified procedure (just as normality happens)» then took in the 
pre-release catatog (S$5S5)» and finally look in the standard release 
catalog (specified by the SESUNAM variabie). 


A more detailed description of the SEARCH directive can be found 
in appendix A. 
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1-13 PROBLEM_REPORTING 
Problems encountered white using a released SES too! should be 
reported using a PSR (Programming System Reports CDC Form AA1901). 
Problems encountered while using a pre-released SES tool should 
be reported using a PTR (Programming Trouble Reports CDC form 
AA3385). 


In both cases the completed form along with all support materials 
should be sent to the Arden Hills PSR Coordinator (ARH273). 
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1214 APPLICABLE DOCUMENTS 


The following is a Jist of documents describing the various tools 
supplied by SES. Note : that SES provides a procedure caiied 
TOGLOOC which provides "on-Jine™ access to many SES documents. If 


you call TOOLDOC without giving any earameters» you get a tist of 
the available DCS documents. 


$ en an wn ew ne oe $-<---— $ ee we ee ee ee eee $ eae ae ee ee ooo + 
H Foot +; Ver 3 Document “Type : DCS Number 3} ipdaten H 
$e ee eo nn oe poone ooo $2 nee ee $e + 
+ SES rans { w~- | User Handbook i: ARH 1833 : 07731781 $ 
: SES Processor ; 1.1 ¢ User Guide +; ARH 2894 + 05/29/79 | 
; EDT ; ~~~ 7? See SES U.H. H ; ; 
$ ACQUIRE 3 ~~~ ? See SES U.H. H H : 
: EXTRACT 3 ~~~ + See SES UH. H H H 
; SESMSG ; ~~- } See SES U.H- H H H 
3 TXTCODE 1 2e0 | User Guide + ARH 2893 $ 02721780 ¢ 
$ TXTFORM ; 1.25 $ ERS : ARH 1737 + 06701/77 3: 
; TXTHEAD 3 tw~~ {| See SES U.He : ; H 
; GENREVP H eee H See SES U.eHe H H ; 
+ CADS DD Tool } 1.0 {| User Handbook i: ARH 3980 ; 03/30/81 } 
$ CADS Graphic Tool 1 1.0 : User Handbook i: ARH 3981 :; 03/30/81 ¢ 
: CYBIL >} 2e0 } Language Spec  { ARH 2298 $ 06/18/81 } 
+ CYBIL $ 200 3 IeDe Handbook : ARH 3078 $ 06/18/81 $ 
:; CYBIL Formatter $ 0.0 } ERS + ARH 2619 3 05/14/81 3 
+ CYBIL Debugger + 12.0 ¢ ERS 3 ARH 3142 $ 09/29/80 $ 
: CYBIL I/70 + 1.60 + ERS : ARH 2739 : 077/18/780 3 
: Sime NOS/VE 1/0 $ 1.0 ¢$ ERS i ARH 3125 $ 01/25/80 3} 
+ C180 CPU Asmb. + 2e2 3 ERS + ARH 1693 ? 02/18/80 } 
$3 C180 PPU Asmb. >; ~~~ 3 ERS $ $2501 s 03/07/78 $ 
$ SES VE Linker + 204 ¢ ERS $ ARH 2816 $ 02/18/80 } 
* SES VE Generator ? 1e1 $ ERS s ARH 2591 : 02/18/80 $ 
+ CO70 OCU + 200 ¢ ERS $ ARH 2922 : 07/18/81 ;$ 
$ C180 Simulator + 520 $ ERS +; ARH 1729 + 03/02/81 ¢ 
; PSEUDO +; 3-0 +: User Guide $ ARH 2892 2 05/29/79 3 
+ SCU (170) +; 1.0 3 ERS ; ARH 1766 : 05/21/7806 $ 
oo fom — $n ew en we ee ooo aa + 
SES UsHe refers to this document 

SES PeWeGe refers to the SES Procedure Writer's Guide (referred 


to above as the SES Processor User Guide -- ARH 2894) 
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The following CDC manuats for NOQS/170 may be of help to users of 


SES. 


69435400 
60445300 


60455250 


60435500 
60450100 


60492600 


— 60328800 


60497809 
60429800 


69481400 


NOS Version 1 Reference Manual (Volume 1) 
NOS Version 1 Reference Manual (Votume 2) 


Network Products Interactive Facitity Version 1 
Reference Manual 


NOS Version 1 Time-Sharing User's Reference Manual 
NOS Version 1 Modify Reference Manual 

COMPASS Version 3 Reference Manual 

SYMPL Reference Manual 

FORTRAN Extended Version 4 Reference Manual 

CYBER Loader Version 1 Reference Manual 


CYBER Interactive Debug Version 1 Reference Manual 
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30% TWOPAGE_=_PRINT TWO DOCUMENT PAGES SIDE_BY_ SIDE 


TWOPAGE takes the output of any of the text processors and places 
two outout pages on one printer pagee This reduces both paper usage 
and print times which is invaluable white documents are in their 
development stages and being turned around fast. 


The input for TWOPAGE must be in 8 of 12 ASCII format and not in 
NOS 6/12 ASCII. Its output is aiso in 8 of 12 ASCII. Parameters to 
TWOPAGE are 3 


jor f 3: 
name of Input Eife to be processed by TWOPAGE., 


(optional) name of Qutput File from TWOPAGE. If you dontt 
code the o parameters the output appears on a file of the 
same name as the input file specified by the i parameter. 


pw or width : | 
(optional) Page Width of the output pages. If you dontft 
code the pw parameters TWOPAGE uses a default page width of 
137 (136 columns plus one cotumn of carriage control). 
Remember to cater for the carriage controi column when 
specifying the page width. 


seq : 
this (optional) key indicates that §$EQuence numbers are to 
be placed on the final printout. The sequence numbers 
apoear down the center of the printer page between the two 
document pages. Default action in the absence of the seq 
key is no sequence numberse 
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Interlock Process for _Undating. a Base or Library 


When updating a base or tibrary you can interlock the update so 
that only one user at a time can update the base or iibrary. Those 
procedures that update a base or library are set up so that if the 
base or tibrary to be updated is in another user's catalogs the base 
or tibrary is interlocked by default. You can override default 
actions by defining a fokmode variable in your profile» or by coding 
a tock or nolock key on the procedures as shown in the diagram on 
the next page. 


Interlocking of a base or Jibrary is done via an interfock filee 
Such a file must be a DIRECT access file in the same user's catalog 
as the base ac Library being uedated. Naturally the intertock file 
must be a PUBLIC» WRITE MODE file if other users are Ifikely to he 
using it. The default name used by the SES source code maintenance 
and tibrary management procedures for the lock file is intriok. You 
can have an interlock file of any name by defining the intriok 
profile variables or by coding a file name as a value for the tock 
parameter on the appropriate procedures. 
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(optional) is a file containing a CORrection Set to be 
applied against the base b before the module om =is 
extracted. If you code this parameter» SES procedure 
TEMPCOR is used to apoly a TEMPorary CORrection set» Note 
that TEMPCOR doesn't actually alter the bases the 
correction set is only applied for the duration of the 
GETMOD(S) rune 


w or width 3; 
(optional) maximum Width of modutes retrieved. 


status or sts ;? 

status is an loptional) parameter that can be used “(for 
those cases where GETMOD(S) is being used as a building 
block of more sophisticated procedures or jobs. The 
status parameter causes GETMOD{(S) to set one of the job 
control registers to the vaiue zero if GETMOD{S) 
successfully complieteds and to non zero if anything went 
wrong during the run of GETMOD(S). The onty vatues that 
may be coded for the status parameter are one of Rls R22» 
R3 or EF. <Any other value coded causes an error message 
to be outputs and the GETMOD(S) procedure aborted. 


msg or nomsg ; 
these (optional) keys control the generation of 
informative messages by this procedure and are “fully 
described in section 1.28 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES”. 


Examples of GETMOD(S) Usage 


sesegetmods {outlinds ltimitsd.e.-oprtypks ststypks symentdeesymk) 
+ END GETMODS GROUP <— BASE 


This example shows GETMODS used to extract a bunch of modules from a 
base. Modules outiinds at! modules Jlimitsd through oprtypks module 
ststypks and ali modules symentd through symk are extracted. Every 
parameter to GETMODS is set to its defauit value. The modutes 
appear on the file group. , 
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id : 
{optional) IDent name for the GENCORS ¥*IDENT directive in 
the generated correction set.» id can be any character 
string that forms a valid MODIFY correction identifier. 
If you don't code the id parameters GENCGRS generates a 
unique correction set identifier. 

sf : 


this (optional) parameter specifies the name of the file 
containing the new version of the modute. If you dont 
code the sf parameters GENCOR(S) uses the name specified 
by the m parameter as the Source File name. 


ts or ignorts : 
these (optional) keys specify whether or not to IJIGNORe 
Leading Spaces on tines being compared. The default action 
is to recognize lteading spaces (the Is option). If you 
code the ignorts keys GENCOR(S) ignores teading spaces on 
text lines. 


fl: 


(optional) parameter to increase the field tlength. If you. 


dontt code the £L parameters GENCOR(S) defaults to a field 
length of 100K. 


mSg or nomsg : 
these {toptional) keys control the generation of 
informative messages by this procedure and are fully 
described in section 1.28 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 


Exampte of GENCOR(S) Usage 


sesegencors mznices b=neats unzby73s nezcorset 
* GENERATING CORRECTION SET FOR NICE ON CORSET 
¥ END GENCORS NICE => CORSET 


This example shows a correction set being generated for module 


nice, The original modute is in base neat in the catalog of user 
by73. 
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4o9 LISTIMQD =-_LIST_ CONTENTS _OE_BASE 


‘ 


LISTMOD performs two main functions : to show you what's iin a. 


bases and to get a printout of the modutes in the base: if 
necessarye LISTMOO first generates a cross reference of the bases 
showing which modules call which moduless and which modules are 
called by which modules (LISTMOD uses procedure XREFMOD to generate 
the cross reference - see the description of XREFMOD if you're 
interested). cLastiys LISTMODD generates a printout of all modules or 
common modules in the base--you can suppress this If you onty want 
the cross reference without the whote base's contents. Parameters 
to LISTMOD are ; : 


bor 1 3 


code the b parameters LISTMOD uses the value of profile 


variable bases and if there's no such variabie defineds | 


LISTMOD wses the defautt name base. 


o 3 
(optional) name of file to receive the Output from 
LISTMOD. If you dontt code the o parameters, a scratch 
file is used for the output and is returned once it has 
benn printed. If you code the o parameter and LISTMOD is 
run in tocal modes the output is placed on the specified 
file and is got printed untess the print parameter is 
given. 

un 3 


(optional) User Name in whose catalog the base specified 
by b is to be found» If you don't code the un parameters 
LISTMOD uses the vaiue of profile variable baseowns and if 
there's no such variable defineds LISTMOD uses the user 
name of the current user. 


batch job parameters : 
These parameters are described in section 147 — “SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in batch nodes but ft can be run in 
local mode. The dayfile parameter is not used by this 
procedure, 


COMPANY PRIVATE 


(optional) name of Base to be processed. If you don't, 


oe ae 


4-39 
COC -—- SOFTWARE ENGINEERING SERVICES 
7/30/81 
4 SES (Release 17) User's Handbook . ewe RENE AB ect 
4.0 SOURCE TEXT MAINTENANCE 
4.9 LISTMOD - LIST. CONTENTS OF BASE 


PE 88 08 OE PO 70 F098 Fae Mead 0 8G 0G tn 8 PE PE Fe PO PE PE PE PE O88 OE PETE PO PO OE OE FE PO PE C8 P8 FE 0 98 PE AE TO 08 OE Pe OE PE 08 8 NR 08 ee 


print : 
{aptional) indicates how the output of LISTMOD is to be 
printed. For the print parameter you may code any of the 
parameters to procedure PRINT. If you dontt code the 
print parameter at alls LISTMOD prints one 11) copy of the 
output on the ASCII printer. 


short or common : 

these (optional) keys contro! which modules are listed 
following the cross reference of the base. If you. omit 
this parameters, LISTMOD tists the source for ali modules 
in the base.e If you code the common keys LISTMOD tists 
onity the common modules from the base. If you code the 
short keys no modules are listed (i.eses only the cross 
reference is produced). : 


Exampties of LISTMOD Usage 


seselistmod print=copies*3s short 
11.17.34. SUBMIT COMPLETE. JGBNAME IS AVOPBUG 
* J08 LISTMOD SUBMITTED 


This exampie shows LISTMOOD processing the base whose name is 
contained in profite variable base. Three copies of the short tist 
{cross reference only) are produced. LISTMOD is run in batchys 
rather than interactively. Running LISTMOD in batch ts the 
preferred nodes since it uses rather a large amount of resources. 


seselistmod bzcidbases oxcidprinsecess 

eo? print=(copies=2s hz'tatest/version of/cidbase!®) 
10.19.2572 SUBMIT COMPLETE. JOBNAME IS ACULBXG 

* J08 LISTMOD SUBMITTED 


This exampte shows LISTMOD run in batch to produce two printouts 
of the cross reference of base cidbases plus the text of all the 
modules in cidbase. 
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3e6 LISTMEM=_LISI_CONTENTS OF LIBRARY | 


LISTMEM performs two main functions to show you what's in a 
librarys and to get a printout of the TEXT members in the library if 
necessaryse LISTMEM First generates a normal CATALOG which shows the 
names of all the members in the library. Lastiys LISTMEM generates 
a printout of ail TEXT members in the tibrary - you can suppress 
this if you onty want the catalog without the whole tibrary'ts 
contents. Parameters to LISTMEM are 32 


ft or b 3 ' 
(optional) name of Library to be processed. If you dont 
code the b parameters LISTMEM uses the vatue of oprofiie 
variable tib as the ftibrary names and if there's no such 
variable defineds the LISTMEM uses the default name tib. 


° 
2 


(optional) name of file to receive the Output From LISTMEM 
Places the output on some unique file name that it 
generates. The output doesn't default to file output 
becauses if you're running LISTMEM interactivelys you 
probably don't want the rather voluminous output on the 
screen. 


(optional) User Name in whose catafiog the tibrary 
specified by # is to be found. If you don't code the un 
parameters, LISTMEM uses the vatue of the value of profile 
variable tibowns and if there isn't such variable defineds 
LISTMEM uses the user name of the current user. 


batch job parameters : 
These parameters are described in section 1.27 - "SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in batch modes but it can be run in 
locat mode. The dayfite parameter is not used by this 
procedureée 


print 3: 
this (optional) parameter indicates how the output of 
LISTMEM is to be printed. For the print parameter you may 
code any of the parameters to procedure PRINT. If you 
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don't code the print parameter at alls LISTMEM prints one 
{1) copy of the output on the ASCII printer. 


short : 
if you code this (optional) keys LISTMEM only generates 
the catalog outputs» and suppresses the fisting of ali the 
TEXT members. 


Exampies of LISTMEM Usage 


seselistmem print=c=3 short 
12634-5646 SUBMIT COMPLETE. JOBNAME IS ACULARS 
* JOB LISTMEM SUBMITTED 


This exampte shows LISTMEM used to process a tibrarys whatever 
name is the value of tib. Three copies of the short list {cataiog 
onty) are being produced. LISTMEM is being run in batchs rather 
than interactively. 


sesetistmem bzeprociib ozprocs print=({cz=2sh="tatest/proctib®) 
18212.00. SUBMIT COMPLETE} JOQBNAME IS ANAPABS 
* JOB LISTMEM SUBMITTED 


This exampte shows LISTMEM being run in batch to produce two full 


printouts of the catalog and aif’ the TEXT members in the library 
procitib.. The titte on the fisting is *tatest proctib'. 
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600 GETTING INEQRNATION 


This chapter describes a collection of SES procedures to find out 
what's going on and what's available. There are two main areas of 
interest : 


le Information about your tocal environment on NOS - what = fites 
you haves your validation Jimitss the times parts of your 
dayfiles and others. 

2e Information about SES - documentss procedures and status. 


CATLIST dispiay comprehensive information about files in a wuserits 
cataloge 


CATALOG gives a condensed tist of the records in a library. 


PERMIT gives permission information for files in a user's 
catalog. 
FILES dispiay tnformation about focal files. 


TOOLOGC prints documents describing toots 


TOOLREP displays status and problems for a specified toot or 
product. 


INFO dispiays the tatest information about SES. 
usspac gets User Supplied Software document. 


USSINFO displays the tatest information about User Supplied 
Software. 
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DAYFILE displays a selected part of your dayfile. 

LIMITS dispiays your LIMITS information in a condensed format. 
DISPLAY displays various information about your job environment 
TIME "talks" the current time as a dayfile message. 


DAYWEEK telis you what day of the week a date fell ons falls on 
{that iss today)» or will fall on. 


SESPROC generates a tist of names of SES procedures, 


SESPARM generates a printout of the parameter tists of SES 
procedures in any selected procedure tibrary. 


COMPANY PRIVATE 


6-15 
CDC ~ SOFTWARE ENGINEERING SERVICES 
7/30/81 
SES (Release 17) User's Handbook REV: AB 


620 GETTING INFORMATION 
6210 TOOLDOC - PRINT TOOL DOCUMENT 


PO BODE RD PO PE BE IO HE AE ON PO OO PE 00 PE PO PE PE BE OE OF FE O08 FE PE PE PEE RE PO PE PE PO OO PE B8 OE PEO P68 08 PE OE AE PE OE DE OD PE PE OD D8 PE DE OE OO PE OE OE 10 PE 08 08 8 PE 


6-10 TQQLQQC_=_PRINT_1OGL_QOCUNENT 


TOOLOGC is the means by which on-line and/or off-line copies of 
TOOL DOCuments are made available. Parameters to TOOLDOC are : 


docs or d 3 


This foptional) parameter is used to indicate which 
document{s) you wish to obtaine Document names are taken 
from the “document number™ column of the document index 
dispiay (see the 'dociist* parameter). The absence of this 
parameter will defauit the proc to dispiay the entire 
document index. 


doctist or di : 


(optional) used to indicate that the document index is to 
be displayed - or retained on a file named by the 'tisting! 
parameter. The ‘'doctist* parameter is ignored if the 
'docs' parameter is specified. Specific portions of the 
document index are displayed by using the fotlowing keys 
with this parameters 

CYBIL - CYBIL Compiler related documents. 


C170 =- SES Development and Supoort tools other than those 
for €180 Project. 

C180 - C180 Operating System devetopment documents. 

OTHER ~- Documents that don't fit into the categories 
above. 

SITE - Documents availabte only at the tocal user's site. 

ALL - Ali of the above categories. This is the default 


if none of the above keys are indicated. 


listing or ?f 3; 


bin 


{optional) name of file to receive the document index 
diselay (when using TOGLDOC without specifying any 
documenti(s))»s or the formatted document(s) themselves. If 
you code the tisting parameter to direct the document(s) or 
the document index to a files that file is not printed. 


(optional) BIN number used at Sunnyvale Development 
Division to indicate the bin number the output is to go 


‘toe If you don't code the bin parameters, TOOLDOC uses the 


value of orofile variabie uwserbins and if there's no such. 
variable defineds generates a bin number of NO-ID. 
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Note that the standard SES batch job parameters are available. 
The defauit is to run the job In batch mode. 


Exampie of TOOLDOC Usage 


sesetooidoc arh2739 
10.36.10. SUBMIT COMPLETE. JOGBNAME IS AAEQAXA 
* JOB TOOLDOC SUBMITTED 


This example would cause the ERS for CYBIL 1/0 to be printed on. 
the system line printer. 


sesetooidoc txdoctist 
* INDEX DISPLAY => DOCLIST 
x TOOLDOC DISPLAY COMPLETED 


This examptie copies the document index to the file DOCLIST. 
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6e11 TOOLREP_=_LIST_TOOL_REPORT 


TOOLREP provides a display of the current status and/or. 
outstanding problems for a specified tool or product. Parameters to 
TOQLREP are 3 


tool or t : 
specifies for which tool or product a report is desired. 
Currenttys the only supported values for the tool parameter 
are SIM180 (the CYBER 180 Hardware System Simulator), CYBIL 
(CYBIL compifers)»s and SCU (Source Code Utility). : 


status or probims : 
if one of these (optional) keys is codeds only that portion 
of the report (status or outstanding problems) is 
displayed. If you donft code either of the keys» both 
portions of the report are displayed. 


(optional) Name of file to receive the Qutput from 
TOOLREP.»j If you don't code the oo parameters the output 
goes to file OUTPUT by default. 

Examples of TOGLREP Usage 


sesetooirep sim180 status 


This exampie of TOOLREP displays the current status of the CYBER 
180 Hardware System Simulator. 


sesetoolirep scu 


This exampie of TOOLREP displays the current status of the NOS 
170 version of the Source Code Utility and known problems with the 
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6013 USIDOC =_GET_USER SUPPLIED. SOFTWARE OOCUMENT 


USSDOC is the means by which on-fine copies of User Supplied. 


Software documents are made available. Parameters are 3. 


product or pr 3 


This (optional) parameter is used to indicate which. 
document you wish to obtain. Document names are the same _ 
as the product itself. The absence of this parameter will. 


defauit the proc to display a catbase listing of what Be 
available on the document fite. 


fisting or 4 : 


(optional) name of File te receive the document you wish co 
retrieve. If you don't conde ths § parameters the output: 


appears on file LISTING. 
Example of USSDOC Usage 


SES-USSOOC PR*GET L=eLISTOUT 
* END USSDOC GET => LISTOUT 


This example retrieves documentation on GET to the file LISTOUT. 
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6014 USSINEO ~_ ACCESS _USS_INEQRMATION 


USSINFO is a#=means whereby users may get up to the minute 
bulletins on changes in User Supplied Software. Parameter(s) to 
USSINFO are 3: 


0 or output : 


(optional) name of file to receive the output from. 
USSINFO. If you don't code the o parameters USSINFO 


outputs the USSINFO file to OUTPUT. 
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6015 SESPROC_=_LIST_SES_PROCEDURE NAMES 


SESPROC displays a tist of procedure names already used by SES. . 
This is of use if you are a procedure writer and wish to create new 
procedures for use in SES. You can then use SESPROC to ensure that 
there Isn't any name conflict. Parameters to SESPROC are : 


un 3 “a 
(optional) tist of user names whose catalogs are to be 

searched for procedure tibraries. SES uses the SES. 
Library NAMe as the name of the procedure Jibrary to look 
for. If you don't code the un parameters SESPROC displays 
the names of procedures in the PROCLIB of the current. 
users and the names of procedures on SES ftibrary. 


o or output : 
{optional) name of file to receive the Output from 
SESPROC,. If you don't code the o parameters SESPROC uses 
file output. 


Example of SESPROC Usage 


sesesesproc unzed73 
UN = ED73 
CETGEN Cottbpoc COLLSUB EDTDOC EDTMOD EDTSUB 
ICGEN MOVDOC MOVSUB PERT PRTDOC PRTSUB RELDOC 
RELSUB REPDOC REPSUB SENDKC WIPEDOC wWIPESUB 
* END SESPROC 


This example shows SESPROC used to determine the names of SES - 
procedures in the PROCLIB of user ed73. 
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6016 SESPARM_=_PRINT_ PARAMETER. REQUIREMENTS _FOR_SES_PROCS 


SESPARM prints out the parameter definitions for ail the 
procedures on a library. It runs batch or tocal with batch as the 


default. Parameters to SESPARM are 3 


name of Library whose parameters are to be printed. 


un 3 
(optional) User Name where the library is to be found. 


you don't code the un parameters SESPARM assumes that the . 


library is in the catatog of the current user. 


o or output or isting : 


(optional) name of File to receive the Output of SESPARM,. 


If you don't code the o parameters the output appears 
file LISTING. 


batch job parameters ; 


These parameters are described in section 1.7 - “SES” 
PROCEDURES RUN AS BATCH JQOBS*. The default for this 

procedure is to run in batchn modes but it can be run in 
focal mode. The dayfile parameter is not used by this. 


proceduree 


print ; 


(optional) parameter to control the PRINTing of =the 
output. When the job runs in batchs one copy is printd 


automaticatiy. If you run the procedure in tocal mode» 


copies are printeds unless you specificatly code some 
print parameter. For exampfes you could code printzcs3 to 
obtain three copies of the parameter tisting. The format 
of the print parameter is that of the parameters for the 


PRINT procedure. 


Note that the parameter tist of each procedure gust terminate 
with a PARMEND directives ors for those records ina tibrary which 
don't thave ae PARMEND directive by virtue of the fact that theyre, 


INCLUDE files» the parameter fist must be terminated by a 
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" \ PARMEND * 


Examptie of SESPARM Usage 


sesesesparm tizproctib unzhk77 local noprint 


DEBUG 

\ PARM KEY = ft NVALS = 1.-MAXVALS NAM 
PARM KEY = (targs's fa?) NVALS = 1 STR 

\ PARM KEY = %p? NVALS = 1..MAXVALS NAM 

\ PARM KEY = %4? NVALS = 1 NAM 

\ PARM KEY = te? NVALS = 12¢MAXVALS STR 

\  PARM KEY = *xid?* NVALS = Lee MAXVALS STR 

\ PARMEND 

BBSBAB“ZAESIS 

DBUGFIN 

\ PARM KEY = (fi% #f9) NVALS = 1 NAM 

\ PARM KEY = ‘48 NVALS = 1 STR 

\ PARM KEY = %b? NVALS = 1 STR 

\ PARM KEY = fo! NVALS = 1 NAM 

\ PARMEND 


* END SESPARM PROCLIB/HK77 -> OUTPUT 


Aftthough this is a rather contrived exampie of a procedure 
fibrary with only two procedures in its it ittlustrates the output 
that SESPARM generates. SESPARM is run in ltocal modes or while you 
waits to produce the parameter definitions for procedures in tibrary - 
prociib in the cataiog of user hk77. The noprint key inhibits 
printing of the generated output. 


Explanation_of the outout of SESPARM 


The diagram on the next page shows the alternative forms of 
parameter definitions of SES procedures. Atternative forms are 
arranged in the vertical coltumnse The biocks of text below provide 
a brief description of each fietd of a parameter definition. 
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NAM 
NUM 
\ PARM KEY = (*K1% 9 *K2%9ee0*Kit) NVALS = mineemax STR REQ RNG 
keyword number FGN 
Weichert DN eh tk es a. Net oa oe LS NL NGI ONS 
a 
9 


ae a6 on 


This command starts 
the definition of an 
SES PARaMeter. 


KEY specifies the key- 
word or keywords that 
may be used when coding 
a parameter for an SES 
procedure. 


oo 4b O08 Se Oe ae ob BH OH Be co wel 


NVALS specifies the Number of VALues 
The 
form mineemax indicates that a minimum 
of "min®™ vatuess and a maximum of “max*® 
values may be coded. If onty one number 
and 
max are the same.w If NVALS specifies a 
value of zero (03s then it indicates 
that there may be no vatues codeds and 


that may be coded for a parameter. 


is specifieds it means that the min 


that the parameter keyword is used as 


option § key. NVALS specified as Oemax 
indicates that the keyword may be used 
as an options or that it may be given 


values. 


This fietd indicates the parameter type. It may 
be NAMes NUMbers STRings ofr ForeiGN text. Refer 
to the INTRODUCTION section for a description of 
parameter types. 


If this field is coded in the parameter 
descriptions, it indicates that that parameter is 
REQuireds and therefore may not be omitted. 


If this fietd is coded in the parameter 


descriptions then it indicates that parameter 
value(s) may be coded as a RaNGes that iss in the 
form firstecelast 


an 


SH BE SS 2B 28 2H GH 2H BB CHO 4H 4H BH HH BH BH 4H CH OH GH OH BH BH FSH CH 4G BO OF 
SS SO Se £6 SE OS SH OBO BH SO BH BH OH BH £6 OH £6 4H OH BH BH CE UH GH CH 2H He 2H 4206 BO GE at BO 


OO Be CO OS BS BE CO FE BH OF BO BH 26 SO OH 28 66 BO 4 BO OH 4H BH HE BH OH Be BE OS 4H Be 08 46 OB He Be on | 


CC ee ewe ee me 
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8.0 COMPILINGs LINKINGs AND DEBUGGING 
8.1 CYBIL ~- RUN CYBIL CC GR CYBIL CI COMPILER 


chk 


to 


the SES. This is done by coding as a vatue for this 
Parameter the user name of the owner of the compiler 
you're after. For examples entering cczip3 accesses the 
version of the CC compiler residing in the LP3 catalog. 
It is necessary for the owner of such a compiler to use 
the file mame CYBILC for the CC version and CYBILI for the 
CI version in order to allow the compiler to be accessed 
via this procedure. 


this (optional) parameter specifies the run-time checks 
the compiler is to generate. If you code ng for this 
parameters no run-time checking code is generated. If you 


code any combination of n (check for de-reference of NIL. 


pointer)» c {check value ranges--range checking may add as 
much as 3 1/2 words to the generated object code for each 
range check performed) and s {check subscript ranges)» the 
corresponding checking code is generated and omitted 
checking options cause the corresponding checks to be 
suppressed. If you omit the chk parameters CYBIL 
generates all flavors of run-time checks. 


this (optional) parameter specifies the Options to be used 
when producing the Listing. Any combination of the 
following designators may be coded for this parameter : 


a specifies that a map of the source input block 
structure and stack is to be produced 


fF specifies that a full tisting is to be produced 
(selects fist options S» As and R) 


0 specifies that the tisting should inctude the generated 
object code in an assembler-ltike format 


Ss specifies that the fisting of the source input file is 
to be produced 


w specifies that the fisting of warning diagnostic 
messages is to be suppressed 


r specifies that a symbolic cross reference fisting is to 
be produced 


ra specifies that a symbolic cross reference tisting of 
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820 COMPILINGs LINKINGs AND DEBUGGING 
8.1 CYBIL - RUN CYBIL CC OR CYBIL CI COMPILER 


ail program entities is to be produced whether 
referenced or not 


x works in conjunction with the LISTEXT pragwnat such that 
LiSTings can be EXTernaliy controlied via the compiter 
call statement. 


If no is specifieds no tisting is produced. If the to 
parameter is omitteds a tisting of the source input file 
only is produced, 


debug or d or nodebug ; 


pad 


this {optionat) parameter is used to select the debug 
options to be in effect for the compitation. The 
availabfe debug options are 3 


sd If this option is setecteds the compiter includes 
Symbol Table information in the object code file to 
be used by the CY8IL interactive debugger. If this 
option is not selected it isnit possible to 
symbolically debug the module(s) being compited. 


fd This option produces the same tables as dz=sd plus 
stylizes the generated code to provide a step 
facility when using the symbolic debugger (it is only 
meaningfuls currentlys when used with the cc 
compiler). 


ds If this option is selected the Debugging Statements 
appearing between 272 nocompite 27? and 
7? compile ?? pragmats is compifeds otherwise such 
statements are skipped by the compiler. 


If you omit this parameter or you code the nodebug§ keys 
none of the sds» fd or ds options are selected. If you 


code the debug or d keys but don't code any valuess 


debugz=sd is used. To setect combined options you can code 
debug=(sdsds) or debug=(fdsds). 


coding a numeric value for this (optional) pad parameter 
generates the specified number of no-ops between machine 


instructions. This feature is used for the P3 


diagnostics, 
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opt : 


this {optiona!l) parameter is used to select optimization - 


levels in the (CI gniy) generated code. Legitimate values 
are : 


0 Provides for keeping constant values in registers. 
1 Provides for keeping focal variables in registers. 
2 Eliminate redundant memory references. 


msg or nomsg : 
these (optional) keys control] the generation of 


informative messages by this procedure and are fully 


described in section 1.8 ~- “INFORMATIVE MESSAGES FROM SES 
PROCEDURES", 


Exampte of CYBIL Usage 


sesecybil foz*orts chk=#snt 
* END CYBIL COMPILE -> LISTINGs LGO 


This example shows the CYBIL CC compiler being used to process 
the program on file COMPILE. A fisting is produced consisting of 
the source inputs generated object codes and a symbolic cross 
references on file LISTING. The object code is written to file LGO 
and will include run-time checking code for Subscript ranges and NIL 
pointer de-reference. 
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Jol SIM1L80_=_ BUN THE CYBER 180 HARDWARE SYSTEM SIMULATOR 


SIM180 runs the CYBER 180 Hardware System Simutator (often 
referred to as the HSS). The hardware system that is simulated 
consists of the foilowing components 


1. CPU 

2e Central Memory (16 Megabytes) 

3e 10410) Peripheral Processors {PPs) 

42 12010) I/70 Channels 

5e 2 7154 disk controllers sharing 4 844-4x disk storage 
units. 

62 2 7155-1 disk controliters sharing 2 844-4x and 2 885-1x 
disk storage units. 

7* 2 7155-14 disk controttlers sharing 2 844-4x»9 2 885-1x 
and 2 885-42 disk storage units. 


S$IM180 sets up the total system sinulated environment and gives 
controft to the CYBER 180 simulator. At this points the user may 
enter any valid simulator command (refer to document ARH1729 <- 
"CYBER 180 SIMULATOR ERS" for command descriptions). Simutator 
commands provide the user with control over the simulated 
environment which includes the following capabilities : 


1. CPU and PP memory toading 

22 Interpretive CPU and PP instruction execution 
3e CPU and PP breakpoint 

4. CPU and PP trace 

5e Display and change Central and PP memories 

62 Dump Central and PP memories to a specified file 
72 Display and change CPU and PP registers 

8. Checkpoint / Restart 

92 On/off CPU and PP simulation 

102 CPU keypoint 
11. CPU program performance monitoring 


The CYBER 180 simulator is intended primarity for interactive use 


(focal mode) but may be readity used In batche An example of batch. 


submission of a Simulator run is given betow. Parameters to SIM180 
are 3 


restart or rs ? 
(optional) name of a checkpoint file from which to restart 
simulation. The checkpoint file may be one previously 
created by GENCPF (GENerate (CheckPoint Eile)s VEGEN 
(Yirtual Environment GENerator), or via the simulator 
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CHECKPOINT command. If you don't code the restart 
parameters a compiete simulated system is created. 


cf : ; 
(optional) name of a command file which is to be processed 
immediatety upon activation of the simulator. The command 
file consists of one or more valid simulator command(s). 
This parameter is required when running in batch. 

1180 or { 3 


(optional) name of file containing input for the special 
simutator CPU I/0 instruction fop code FF(16)). If you're 
running SIM180 interactively and dontt code the i180 
parameters, SIM180 takes its Input from a file assigned to 
your terminal. If you run S$IM180 in batch and use the CPU 
1/0 instruction for input» you must supply ae file 
containing the input. 


0180 or o 3? 
(optional) name of file to receive output from the special 


simulator CPU I/O instruction lop code FF{16)). If you're 


running SIM180 interactively and don't code the 0180 
parameters SIM180 sends output to a file assigned to your 
terminal. If you run SIM180 in batchs you must supply a 
file to receive the outputs otherwise the output is lost. 


Exampies of SIM180 Usage 
sesesiml180 
** I SM 6052: CYBER 180 SIMULATOR VER 62-4 LEV 126 (MIGDS REV S$) 
This example shows SIM180 used interactivelys to create a new 


simulated system environment. The user may enter any simulator 
command once the simulator banner is displayed. 


sesesiml80 rsecheckl cfzerrata 
** J] SM 6052: CYBER 180 SIMULATOR VER 644 LEV 126 (MIGDS REV 9) 


This exampte shows SIM180 used to resume simutation from a 
checkpoint file. The command file errata is processed before 
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requesting additional simulator commands from the user. 


sesesiml80 checkx izindata ozoutdata 
** IT SM 6052: CYBER 180 SIMULATOR VER 6.4 LEV 126 (MIGDS REV 5S) 


This exampte shows SIM1L80 used interactively» to resume 
simulation from the checkpoint file checkx. The special simulator 
CPU I/O instructions when encountered during CPU instruction 


simulations is to read input from file indata and is to write output 
to file outdata. 


sesedo batchns filezsimcfseseaee 
ee? csz=(*sesesiml80 postdss cfssimcfs orprogout!s.cees 
ee? *savessesiog!) 
15254%.28. SUBMIT COMPLETE. JOQBNAME IS AAAQCBN 
¥ J0B DO SUBMITTED 


This example shows SIM180 submitted for batch running via the SES 


DO procedures. Simulation will resume from the checkpoint file 


postds, the simulator commands in the file simcf are processeds and 
any output from the special simutator CPU I/0 jInstruction is 
directed to file praogout. Refer to the description of the SES DO 
procedure in the "Miscellaneous Useful Goodies" section for an 
explanation of using DO to submit multipte control statements to 
batch. 
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9013 GETLDB_=_ ACQUIRE BINARY FOR_ENVIRs INTs LOADER 


GETLDB acquires the absolute binary to run the HCS Environment 
Interface foader. There are no parameters. 


Example of GETLDB Usage 


sesegetidb 
¥ END GETLOB VGENLDB IS LOCAL 
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Each mainframe has been assigned a site identifier. These site 
identifiers are : 


ARH - Arden Hillis 176 S/N 101 
SVL - Sunnyvale 176 S/N 112 
AS2 —- Arden Hills $2 


Note :; As additional systems are added to the networks they are 
assigned a site identifier. 


In addition to the site-ids each user must have a valid user 
names passwords charge number and project number for the target 
machine. These may be coded into your PROFILE. The PROFILE 
variables are created by concatenating the site-id with 'fam' for 
family names fuse! for user names '"pas' for passwords ‘chat for 
charges and ‘prot for projecte Users may have PROFILE variables for 
each remote mainframe they are validated to run jobs one In 
interactive modes the remote fink procs requests the family names 
user names passwords charges, and project variables if they are not 
in your PROFILE. 


Note : that in batch mode» the variabie must exist in vour PROEILE> 
or the jiob aborts. 


EXAMPLE : The variables needed for a Sunnyvale user to run jobs 
on the Arden Hilts S2 would be 3 


PROFILE 

\ AS2USE = "your $2 user name* 

\ AS2PAS = "your S2 password? 4 
\ AS2CHA = "your S2 charge number? ‘ 
\ AS2PRO = *your S2 project number! 

\ AS2FAM = "your $2 family name? 


If the value for a remote site charge parameter is set to a null 
string (for exampte SVLCHA = '')s the remote tink procedures omit 
the CHARGE statement in the job contro! statement stream that is 
sent to the remote mainframe for execution. a 


If a remote site family name is set to a null string (for example 
ARHFAM = *4)5 the family parameter isn't specified on the USER 
statement. : 
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14.15 CONY =. CONVERT CHARACTER SET 


CONV converts text Files from one character set to another. NOTE 
- Due to its flexibilitys the conversion process is fairty time 
consuming. Parameters to CONV are 3 


ior f : 
name of the Input File containg text to be converted. 


(optional) name of the file to receive the Output from 
CONVe. If you don't code the o parameters the output 
appears on the file specified by the i parameter, 


incset or ic : 
designator for the INput file's Character SET. See the 
table betow for a description of the allowed designators. 


outcset or oc : 
designator for the OUTput file's Character SET. See the 
table below for a description of the allowed designators. 


The following tabie defines the designators atiowed for the 
incset and outcset parameters: 


Designatoc Meaning 

N63 NGS 63 6-bit codes 

N64 NOS 64 6-bit codes 

N612 NOS 6/12 ASCII 6-bit and 12-bit codes 

N612U same as N612 except that all tetters are upper 
case 

N612L same as N612 except that all tetters are tower 
case 

NBE63 NOS/BE 63 6-bit codes 
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NBE64 NOS/BE 64 6-bit codes 
NBE63A NOS/BE ASCII 63 character subset 77-bit codes (5 
per word) 
NBE64A NOS/BE ASCII 64 character subset 7-bit codes (5 
per word) 
ASCII4 full ASCII 77-bit codes (4 per word) 
ASCII5 Full ASCII 7V-bit codes (5 per word) 


A table of these characters sets can be found in an appendix to 
this document. 


COMPANY PRIVATE 


14-27 
CDC — SOFTWARE ENGINEERING SERVICES 
7/30/78 
| SES (Release 17) User's Handbook 7 REV: AB 
14.0 TEXT MANIPULATION AND CONVERSION UTILITIES 
14. 16 JABFORM — CONVERT TEXTJAB SOURCE TD TXTFORM SOURCE 


PO PETE PE PE OF OR PE FO PD TE OE PO NE PO Pee mee Pe re 0 ED 20 0 PO PE 0 PG PE PO PO 8 90 TOO 08 88 8 lA iE Mh a aden Bit Bed Died nd Ao Bindi ded 


14.16 JABEQRM_-~_ CONVERT _TEXTIAB SOURCE _TO_TXTEQRM SOURCE 


JABFORM converts source for the TEXTJAB document formatter to 
source for the TXTFORM document formatter. JABFORM only works on 
TEXTJAB source format directives that are delimited. Parameters to 
JABFORM are 3 


ior f : 
name of the Input File containing the TEXTJAB document 
sources 


name of the fite on which the TXTFORM source is written 


Gut. Note that unlike many other SES procedures JABFORM 
doesn'tt overwrite the Input file with the Qutput file. 


o 
oe 


(optional) name of the file to receive error messages from 
JABFORM. If you don*t code the e parameters JABFORM uses 
file ERRLIST. 


A comptete description of the conversions performed by JABFORM 
can be found in an appendix to this document. 
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1541 LAE_=_SEL_UP_INITIAL_IAE_TERMINAL PARAMETERS 


The IAF procedure defines your terminal to the NOS IAF facility. 
In additions it will notify you of MAILBGX messages» and uedates to 
SES»~INFQ. 


There are defaults for ail the different terminal types» and 
normally» the user only specifies his/her terminal type either on 
the proc call or in his/her PROFILE. Atl the strange parameterss 
including the terminal types may be set up in your profile. As an 
examples if you're logged in to a CDC 713 terminals you can set up 
the terminal controts by simply typing 3 


seseiaf term=cdc713 


The table on the next page describes the parameters for IAFs the 
defauitss and the profile variabites that you can set to change the 
defaults chosen by the IAF procedure. 


Note : while the IAF procedure is runnings do not hit carriage 
return (CR) to find out what's going ons even if it does seem a 
fittie slow. At the time of writings due to the way the NOS TRMDEF 
command workss hitting a carriage return interferes with the TRMDEFs 
which will issue a line of garbied data to your terminals and the 
TRMDEF command gets ignored. In other wordss the IAF procedure 
won't do anything. 
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device on your IST3»s the 
defaults for ci and ti 
are changed to 50 each. 


ee ae Ge ee De ee ee ee ee ee ee 2 ee ee eo a ee a ae oe oe 


+ + + + + 
H ; H ; H 
+ Parameter : Default + Profile ;: Parcametec : 
; Name : Value 3 Vaclable ; Usage : 
$ ew ee ee eee $2 nee ee $ www ee eee fe nt 
; terms t ; No Defauit : term : Terminal type. For ai 
; H H ; list of the terminal $ 
H H H i types currently 3} 
; ; 3 : recognized by the IAF 3 
H H H $ procedures see the tist 3} 
H H ; $3 at the end of this i 
H ; H ; table. ; 
$ mee ee oo $e ene ~~ he a a ne ee ee + 
: intchrs ic {; see betow ; intcher $ character to INTERRUPT a 3 
H H H ; PIecessis ; 
$e ee ee ee $e ne ee ee ee fe ee a fe ee a ee + 
H cerackts te ; see below : termchr 3; Shareetee to "TERMINATE a 3 
H H ; 3 process. H 
$n ene a res teen nee fw ee ee + 
; Sanches cc 3 see below ; eanehe H whacacten to CANCEL ai 
; H ; $ tine input at the $ 
; H H 3; terminal. : 
$ wen en ee ee $e ean ae ee $a eee ee $e nnn a ee + 
3 senches ct i see below : eoacne ; character to use as. a 3 
H H H $ CONTROL character. when ? 
3 H H $ giving commands (such as } 
H ; H ; page wait on or off) to } 
H ; H ; the TIP. : 
$e nee mewn en $m nen en wee eee $ owen ee fw ee + 
> half/full : full : duplex ; determines whether your : 
: 3 : + terminal is to run in $ 
H H H $ HALF or FULL dupfexe $ 
; H ; : These are just keys. H 
$ wwe wn ne oo ee owen ewe ee ee $ewe ene fe a oe + 
; ci : 0 ; ci ; Carriage return idie ; 
H 3 H : eount for IST3 or TI745. 3: 
$oen = $e oe ee $e ee $n a a ene we + 
; 441i : 0 > Vi ; tine feed idje Sodne for $ 
: 3 H : IST3 or (ites H 
eS 0 eee fp ae en oe ae ms oe ee ae ee ae ee ee a ee a De DN + 
+ hardcpy ; no ; hardcepy i If you use a hacdcoey H 
H H ; H ; 
2 H ; : H 
H H ; H H 
+ + + + + 


A Se AD ee ED aD El “sae RD ile ND ane wee SD RE OND a AD A A OED ee ee a a ee iP cn ae ae ane ane ee een a 


The defaults given aboves namety "IAF default™s are those chosen 
by IAF (part of NOS)s as opposed to [AF (the SES procedure). We 
have copped out by not stating what they are heres since they change 
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from time to time. For a sist of the defauitss consult the IAF 
reference manuals or see your toca! NOS wizard. 


The term (for terminal) profile variable is set up when you use 
BLDPROF (BuilD PROFile)»s and the IAF procedure uses this profile 
variable. If you use the IAF procedure and no terminal type is 
specifieds either via the term parameter or the term profile 
variables IAF prompts for the terminal type. You can edit your 
profile to insert alt’ the other defauits if you wish. 


Terminal types that the IAF procedure knows about at present 
are 3: . 


COC713»5 COC751» CDC752» DX132As NCRO209 TI745s TTY43s DECW3>» 
TEK4014» IST3. 
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The table below describes the control characters and other 
parameters that the IAF procedure establishes for youre Nate : that 
a page width of zero (0) allows the maximum page width. 


pp 86 oe 06 OO 8H SO 4D He be oe we hh Oe we ot hb oe 86 be hf HE oe 68 Oe 4b Oe 48 we H 


eee ene} en ee ee tome nee = foe eee $e ea tenn fee nn treme + 
TERM- {CONTROL $ CANCEL ? INTER- | TERN- {PAGE { PAGE {ECHO- $ 
INAL { CHAR {$ CHAR #$ RUPT { INATE WIDTH? LENGTH 3PLEX 3 
TYPE 1 CHAR $ CHAR {MODE 

i a : 

weer wn $e a fe no fp a fh rn rn ne pn fp wn nnn fa = + 

, : ; : : 
COC713 } ESCAPE $ LINE $ STX $ ETX ¢$ O $ 16 $ FULL 
$ CLEAR } : : : : : 

a 3 3 ,] a a 8 § 

8 s 5] a 8 a | 8 

a oe or 
: : : : : : 

CDC751 3 ESCAPE $ GS P CTRLVP $ CTRL/T 2? 0 $= «6024 «63 FULL $ 
: : : : 

eee nee pw wm ne fn an =f nf er ne fan we fo nf = + 
: : : : : : 

CDC752 3 ESCAPE ! CTRL/X $ CTRL/P i CTRLVT $ 0 $ 24 ¢ FULL 
5 a a 9 8 8 i] 3 

% a 4 8 a % 3 2 

eee Se oar 
: : : 

DX132A $ 9% «= $ CTRL/X $ CTRLVP 3 CTRLVT 2.132% 30 ¢ FULL } 
4 s | a 3 s a 8 

a i] a | a a a 3 

m2 --- pe wn ff rn wf ow wn ff er nn oe fn fe ee nn ne ton ne = + 
: : 

NCR260 $ : : : : : : : 
TI745 3 : : 
TT¥43 $ ESCAPE $ CTRL/X ! CTRL/P $ CTRL/T $ 0 3 N/A ¢ FULL $ 
DECW3 2 : : : 
TEK4014! : 
IST3) 3 : 
2 a 8 8 ] e a % 

a. % a a a | 4 s 

eee bf a a a a ae fn anf fn pn nee fn 


The default values can be changed by coding a parameter that 
corresponds with one of the columns marked with *. If haif dupiex 
is desireds simpliy code the half key. 


Nete : when specifying an octal code to change a default values 
remember that the radixs enctosed in parentheses» must follow the 
numbers for example 3: 

conchr #338) 
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17.0 STRUCTURED PROCESS TOOLS 


17.0 STRUCTURED PROCESS _TOQLS 


CADS=_COMPUTER_ AIDED _ DESIGN _OF_ SOFTWARE 


The structured process tools are a set of Data Dictionary 
utitities and a Computer Graphics Design tool. They support the 
Structured Analysis/Structured Design {(SASD) methodology used for 
development of software. 


CADSG creates or updates DFD» SCT and 05D diagrams used in the 
SASD methodology. 


CADSGUT tists or edits diagram titie biocks. 


DDCREAT creates a data dictionary. 


DDDIS displays the contents of a data dictionary. 


DDOMERGE merges the contents of two data dictionaries into a single 
data dictionary. 


DDOXREF prepares across reference listing of a data dictionary, 


DOXCHK checks a data dictionary for consistency. 
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17.0 STRUCTURED PROCESS TOOLS 


The Computer Graphics Diagram tool supports the Data Fiow Diagram 
(DFD)»s Structure Charts (SCT) and Oata Structure Diagram (DSD). 
These diagrams can be createds printeds saveds recalled and updated 
using a TEKTRONIX 4014 or IST-III Graphics Terminal. Other 
terminals will be supported in tater versions. See the “Applicable 
Documents” section of this document for the manual that supports the 
CADS Graphics. 


The Data Dictionary Utilities provide a set of creations 
updatings checking and printing functions. Version 1.2 consists of 
CREATEs DISPLAYs MERGEs XCHECK and XREF functions. Later versions 
wilt aiso contain an EDIT function. See the “Applicable Documents" 
section of this document for the manual that supports the Data 
Dictionary. 
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17.1 CADSG_-_CREATE_OR_UPDATE_SASD_OLAGRAMS 


The CADS Graphics tools CADSGs supports the creation and 
maintenance of Data Flow Diagrams (DFD)s Data Structure Diagrams 
(DSD) and Structure Charts (SCT). These diagrams are the primary 
diagrams used in the SASD technique. See the SASD GRAPHICS USER'S 
HANDBODKs ARH3981s for details of this toot. Parameters to CADSG 
are 3 


ntbk 3 
loptional) name of the file to be used as the current 
notebook. If you don't code this parameters, CADSG uses the 
value of the profile variable ntbks and if there's no such 
variable defined in your profiles then CADSG uses the 
filename NOTEBK. 


newntbk : 
(optional) name of the file to be used as the new 
notebook. If you don*t code this parameters CADSG writes 
the notebook back to the current notebook file (see ntbk 
parameter). 


term 3 
(optional) name of your terminal types TEK4014 or IST3. If 
you don't code this parameters CADSG uses the vatue of the 
profile variabte terms and if there's no such variable 
defined In your profites then CADSG will ask you which 
terminal type you have. 


baud ;: 
(optional) baud rate you are running with your terminal. 
If you don't code this parameters CADSG uses the profitfe 
variable bauds and if there's no such variable defined tn 
your profiles then CADSG will ask you for your baud rate. 


hardcpy : 
(optional) do you have a hardcopy device attached to your 
terminal? YES» NOs Y or Ne If you don't code this 
parameters CADSG uses the profile variable hardepys and if 
there's no such variable defined In your profiles then 
CADSG wilt ask you if you have a hardcopy device, 
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egm : 
{TEX4014 onlys optional) do you have the Extended Graphics’ 
Modules EGMs on your TEKTRGNIX 4014 terminal? YES» NOs Y 
or Ne If you don't code this parameter for the TEK4014s 
CADSG uses the profile variabie egms and if there's no such 
variable defined in your profiles the CADSG will ask you if 
you have EGM. 


sync : 
(TEK4014 only» optional) are you running synchronous or 
asynchronous? A or 5S. If you don't code this parameter 
for the TEK4014s CADSG uses the profile variable syncs and 
if there's no such variable defined in your profiles then 
CADSG will ask you which you are running. 


New Notebook 
If the File name does not exist or is emptys a new notebook is 
created. Use the NEW command within CADSG (see SASD GRAPHICS 
USER*S HANDBOGK ARH3981). 
Examptes of CADSG Usage 


SES eCADSGsNTBK=MYBODKs NEWNTBK=MYNEWBK 
* BEGINNING CADSG ON MYBOOK 


( Interactive session with CADSG ) 
* END CADSG NOTEBOOK MYBOOK <-> MYNEWBK 
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17.2 CAQDSGUT =_LIST_OR_ EDIT DIAGRAM _ TITLE BLOCKS 


The CADSGUT SES procedure for R1.2 provides a utility for 
complete or partial tisting of the notebook fiie diagram titie 
blocks and/or reptacement of fields within these titles. 


The call format is: 


SES -CADSGUTsntbk=pfnlsnewntbk=pfn2sLIST 


ntbk ; 
(optional) name of the file containing the diagram 
records. If this value is not specifieds the procedures 
will use the vatue of profifte variable ntbk as the input 
file name. If no variable is defineds CADSGUT uses the 
name NOTEBK as the name of the Input diagram file. 


newntbk : 
(optional) name of the file to which the edited and/or 
converted diagram records are written. If this variabte is 
not specifieds CADSGUT uses the default name NEWNTBK as the 
name of the output file. 


tist ;: . 
If ist toptional) is specifieds, CADSGUT performs = an 
SES.~PRINT of the compliete diagram titie information from 
all diagram records contained on the input File. 
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17-3 DDCREAT_=_CREATE_A_DATA_OICTIOGNARY 


The DDCREAT penekion takes a user text input file and creates a 
Data Dictionary (DD) file. Parameters to BOCREAT are 3: 


i: ; 
{optional) name of the file containing the source data for 
creating the OD. If you don*tt code the i parameters then 
DDCREAT uses the value of the profile variabie ddis and if 
there's no such variable defined in your profites then 
DOCREAT uses the filename DDTEXT. The i file is not 
rewound. 

new : 


(optional) name of the file onto which the new 00 is to be 
written. If you don't code the new parameters then DDOCREAT 
uses the vatue of the profile variable ddnews and if 
there's no such variable defined in your . profifes then 
DDCREAT uses the file name NEWDD. : 


Exampte of DDCREAT Usage 
SES-DDCREAT I=MYTEXTs NEWeMYNEWDD 
* BEGINNING 0D CREATE 


( Additional informative messages from DDCREAT y 
* END DD DDCREAT MYTEXT ----> MYNEWDD 


This example shows DDCREAT used to create a new data dictionar ys 
MYNEWDDs from the text in the source file MYTEXT. 
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17.6% DDDLS_=_DLSPLAY_A_DATA_DICTIONARY 


The DDDIS function extracts entries from a data dictionary and 
writes them to an output text file. Extraction criteria are 
specified by directives on a directives file or by specifying a type 
keys. (See Data Dictionary User's Handbook ARH3980.) Parameters to 
DDDIS are : 


oid : 
{optional) name of an oid data dictionary file from which 
to display a text file. If you don't code this parameters 
then DDDIS uses the vatue of the profile variable ddotds 
and if there's no such variable defined in your profiles 
then DDDIS uses the filename OLDDD. . 


(optional) name of the file to receive the output from 
DDDIS in a form suitable for inclusion as tasis' text in $a 
FORMATted document. If you don*t code this parameters then 
DDDIS uses the value of the profile variabie ddos and if 
there's no such variable defined in your profiles then 
DDOIS uses the filename DDTEXT.. 


(optional) name of the file containing directivess in NOS 
ASCII tine-image formats to the DDDIS processor. If you 
don't code this parameters DDDIS uses the value of the 
profile wvariabie ddd. If there's no such profile variable 
defined in your profile and a type key is not specified, 
then DDDIS accepts directives fron your terminal ors in the 
case of a batch jobs from the filename input. The d_ file 
is not rewound. If you code the d parameters don't code.a 
type key. 


type ; 

foptional) key specifies a  DDDIS directive keyworde 
Acceptable values for type are: ali» altlhs datas files 
flows compones elements processs prochs modutes actions 
actionhs dfds dfdh»s scts notypes and undef; don't inctude a 
backsiash.e. Coding the type parameter is eauivalent to 
specifying the directives "\keyword Vend™ on a d 
(directives) file. If you code the type parameters don't 
code the d parameter. 
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print : 

{optional) parameter to control the PRINTing of the output» 
o file. When the job runs in batch mode and there is no o 
files one copy iis printed automatically. If you run the 
procedure in iocai. modes no copies are printed uniess you 
specifically code some print parameter. For examples you 
code print=c23 to obtain three copies of the parameter o 
file. The format of the print parameter is that of the 
parameters for the PRINT procedure. 


Examele of DDDIS Usage 


SESeDDDISs OLD=MYOLDDDs OeLISTITs D=DOWHAT 
* BEGINNING DD DISPLAY 
* DD DISPLAY ACCEPTING DIRECTIVES 


( Additional DD / User Interaction ) 
* END DD DDDIS MYOLDDD ----> LISTIT 


This example shows DDDIS used to display selected entries from the 
data dictionarys MYOLDDD. The directives for selecting entries were 
read from the file DOWHAT. If this parameter had been omitteds 
directives would have been read from the file INPUT. The tisting of 
formatted data dictionary entries was written to the fite LISTIT in 
the order selected by the directives read from the file DOWHAT. 
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17-5 DDMERGE = MERGE TWO DATA DICTIONARIES 


The DDMERGE function combines two data dictionaries to produce a 
new one. Parameters to DOMERGE are : 


old : 
{optional) name of the old data dictionary file with which 
you wish to merge another data dictionary. If you dontft 
code the otd parameters then DDMERGE uses the value of the 
profile variable ddotds and if there's no such variable 
defined in your profites then DDMERGE uses the filename 


OLDOD. 

m 
(optional) name of the data dictionary file you wish to 
merge with the otd data dictionary. If you don't code the 
m parameters DDOMERGE uses the value of the profile variabte 
ddms and if there's no such variabte defined in your 
profiles then DDMERGE uses the filename merdd. 

new : 


(optional) name of the file onto which the new DD is to be 
written. If you don't code the new parameters then DDMERGE 
uses the vatue of the profile variable ddnews and if 
there's no such variable defined in your profiles then 
DDMERGE uses the file name NEWDD. 


replace : 
{optional) key causes entries contained in the old data 
dictionary whose names are duplicated by entries contained 
in the m data dictionary to be REPLACE'd by the m data 
dictionary. The filename DDLOG will contain a fist of 
dupticate entries and the action taken in each case. 


Exampte of DDMERGE Usage 
SESe-DDMERGEs OLD=MYOLDDDs M=MERGEDDs NEW*MYNEWDDs REPLACE 
* BEGINNING DD MERGE 
* END DD DDOMERGE MYODLDD + MERGEDD ----> MYNEWDD 
This exampte shows the use of DDMERGE to combine entries from the 
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17-6 QDXREE_=_CROSS_REEERENCE_A_DATA_ DICTIONARY 


The DDXREF function oroduces a formatted cross reference tisting 
of part or all of the otd data dictionary file. Parameters to 
DOXREF are 3 


otd ; 
(optional) name of the otd data dictionary file from which 
you want across reference listing. If you don't code the 
old parameters then ODDXREF uses the vaiue of the profile 
variable ddoitds and if there's no such variable defined in 
your profiles, then DDOXREF uses the filename GLDDD. 


(optional) name of the File to receive the output of DDXREF 
in a form suitable for printing on the ASCII printer. If 
you don't code the {! parameters then DDXREF uses the vatue 
of the profite variable ddtist. If there's no such 
variable defined in your profiles and you're running DDXREF 
LOCAL at your terminals the output appears on a file calited 
LISTING. The ¢ file is not rewound. 


type 3 
(optional) key selects the type of entries you want to be 
Included in the cross reference tisting. Acceptable values 
for type are: flows compones elements files datas processs 
modules dfds scts notypes actions undefs and all. 


print ; 

(optional) poarameter to control the PRINTing of the outputs 
§ file. When the job runs in batch mode and there is no 1 
files one copy is printed automatically. If you run the 
procedure in tocal modes no copies are printed unless you 
specificaliy code some print parameter. For examples you 
code printzc=3 to obtain three copies of the parameter i 
file. The format of the print parameter is that of the 
parameters for the PRINT procedure. 


Example of DOXREF Usage 


SES-DDXREFs T*#MYOLDDDs LeLISTITs ALL 
* BEGINNING DD XREF 
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{Additional informative messages from ODXREF) 
* END DD DDXREF MYODLDDD ~--=-> LISTIT 


This exampie shows the use of DDXREF to obtain a cross reference 
listing of afl sections of the data dictionary MYOLDODD. The cross 
reference listing will be on the tocal File LISTIT.~ Printed copies 
could have been obtained by adding the PRINT parameters 
PRINT=(C=3sH=*XLIST*®). This will print 3 copies with a header 
*XLIST!*. 
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17.7 DOXCHK = CHECK. A_DATA_ODICTIONARY_£OR_ CONSISTENCY 


The DDOXCHK function runs across check against a data 
dictionary. A formatted listing is produced which contains the 
names of entries which meet criteria selected by the check 
parameter. Parameters to DDXCHK are : 


oid ; 
{optional) name of the old data dictionary file you want 
cross checked. If you don*t code the old parameters then 
DOXCHK uses the vatue of the profile variable ddotds and if 
there's no such variable defined in your profiles then 
DOXCHK uses the filename OLDDD. 


(optional) name of the file to receive the output of DDXCHK 
in a form suitable for printing on the ASCII printer. If 
you dontt code the 1! parameters then DDXCHK uses the value 
of the profile variable ddfist. If therets no such 
variable defined in your profiles and you're running DDXCHK 
focal at your terminals the output appears on a file caited 
LISTING. The # file is not rewound. 


check : 
{optional) key specifies the kind of consistency check you 
want run against the otd data dictionary. Acceptable 
values for check are: undefs unrefs norefs recurs and 
full. 


print : 

(optional) parameter to controt the PRINTing of the outputs 
{ File. When the job runs in batch mode and there is no 1 
files one copy is printed automatically. If you run the 
DDXCHK procedure in focal modes no copies are printed 
unfess you specifically code some print parameter. For 
examples you code printezc=2 to obtain two copies of the 
parameter t file. The format of the print parameter is 
that of the parameters for the PRINT procedure. 


Example of DOXCHK Usage 
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SESeDDXCHKs I=MYOLODDs L=LISTITs FULL 
¥ BEGINNING DD XCHECK 

( Additional informative messages from DDXCHK ) 
* END DD XCHECK MYOLDDD ----> LISTIT 


This example shows the use of DDXCHK to perform a full cross check 
of the data dictionary MYOLDDD. The cross check listing will be on 
the focal fite LISTIT. Printed copies could have been obtained by 
adding a PRINT parameter. 
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M=mode specifies the access mode desired for the file 
(READ or R -—- the defauits WRITE or Ws or EXECUTE 
or E). If the file is locals the mode will not be 
changed. To insure the mode will be changeds the 
PO parameter should also be specified. 
PWzpw . specifies the permanent file's password 
PN=pn specifies the packname for the permanent file 
When ACQUIRE is attempting an ATTACH or GETs if the file is busy 
or if a permanent file utility is actives the following message is 
issued and the request is retried 3 
- WAITING FOR PFN=zpermanent_file_name UN=zuser_name 


When ACQUIRE is attempting an ATTACH or GET» if an error is 
detected by PFM the following message is issued and ACQUIRE aborts 3: 


- ERROR WITH PFNzpermanent_file_name UNzuser_name 


In both of the above casess the designated message is preceded by 
amore specific message generated by PFM. 
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Fle0 EDT =_ENHANCED VERSION _OF_NOS_TEXT EDITOR 


EDT is an enhanced version of the standard NOS text editor 
(EDIT). EDT incorporates column searchess modified FIND and FINDS 
commandss Input and Output File and TAB specification on the EDT 
calls control over terminal interruptss INPUT MODE optionss muttipie 
entries on command finess command bufferss permanent file functions» 
and miscellaneous other additions. 


User documentation can be found on TOOLBOC (SESD009). 


Fiel EDT_CONTROL_ STATEMENT _£ORMAT 


EDToLIfnL]slifn2]elifn3ieltableLomdstr] 


tfni - name of the file to be edited 


tfn2 ~ name of the file containing the editor commands 
(default = INPUT) 
- $f Os an END command is executed after processing the 
commands in cemdstr 
- «f l» commands are read from file INPUT after 
processing the commands in cmdstr 
tfn3 - name of the output file (default = OUTPUT) 


tab - tabset to be used by EDT 


cmdstr editor Command String to be executed if !fn2 = 0 or 1 
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are assigned USS numbered fillies» and are kept in the SES catalog. 
The source for user supofied software is colfected onto a 
semi-private SCU PL called USSPL and kept in the SES catatog. If 
the author requests that it not be accessibles the source is kept in 
a private SES file. 

The major advantage of maintaining user supplied software is the 
SES catalog is than any changes or new software are automatically 
sent to the sites receiving the regular SES updates. 


M123 COMMUNICATING AVAILABILITY DF _USER SUPPLIED SOFTWARE 


An online directory (USSINFG) of user supplied tools is 
maintained on the SES catatog. This fite contains a short 
description of the tool provided by the developer. This description 
is atso circutated via the Advanced Systems Development Productivity 
Circle and/or the SES Tools Bulletin. 

Hard copy documentation supplied by the user is available from 
SES on request or online via TOOLDOC. 


M1.4 SUPPORT _OQE_USER_ SUPPLIED SOETWARE 


All correctionss improvements or other modification to user 
suppiied software are the responsibility of the person supplying the 
software. SES does not support any user supptied software. 

If software supplied by a user is standardized (it becomes a SES 
supported product) it is removed from the user supplied category. 
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